ITK/Doxygen Documentation: Difference between revisions

From KitwarePublic
< ITK
Jump to navigationJump to search
No edit summary
Line 58: Line 58:


List of most common doxygen commands:
List of most common doxygen commands:
* '''\class'''  see http://www.stack.nl/~dimitri/doxygen/commands.html#cmdclass
* '''\class'''  see [http://www.stack.nl/~dimitri/doxygen/commands.html#cmdclass command documentation]
* '''\brief'''  see http://www.stack.nl/~dimitri/doxygen/commands.html#cmdbrief
* '''\brief'''  see [http://www.stack.nl/~dimitri/doxygen/commands.html#cmdbrief command documentation]
* '''\tparam''' see http://www.stack.nl/~dimitri/doxygen/commands.html#cmdtparam
* '''\tparam''' see [http://www.stack.nl/~dimitri/doxygen/commands.html#cmdtparam command documentation]
* '''\sa'''    see http://www.stack.nl/~dimitri/doxygen/commands.html#cmdsa
* '''\sa'''    see [http://www.stack.nl/~dimitri/doxygen/commands.html#cmdsa command documentation]


== Documenting Methods / Functions ==
== Documenting Methods / Functions ==

Revision as of 17:27, 9 May 2011

Dependencies

Generating a complete doxygen documentation requires (apart from cmake and ITK source code)

Generating the Doxygen documentation

Complete doxygen documentation

To generate the complete doxygen documentation (of the whole toolkit), the same as the online doxygen documentation

  • In CMake BUILD_DOCUMENTATION must be turned ON !!
  • Build the project as you would normally do, it will build both the ITK libraries/binaries and the doxygen documentation

Note that depending on your machine, this process can take a lot time.

Enabled modules documentation

To generate the doxygen documentation of enabled modules documentation (a subset of the complete one)

  • In CMake BUILD_DOCUMENTATION and DOXYGEN_MODULE_ENABLED must be turned ON !!
  • Build the project as you would normally do, it will build both the ITK libraries/binaries and the doxygen documentation

Documenting classes

Here is a simple and minimal example:

<source lang="cpp"> /** \class MyAwesomeClass \brief Short Description of MyAwesomeClass

Here you can start writing a more detailed documentation for MyAwesomeClass.

To document each template parameters: \tparam T1 documentation for the first type \tparam T2 documentation for the second type \tparam VDimension documentation about the third template parameter which seems to be related to the Dimension

You can make implicit references to any other ITK class, by just writing their names, e.g. Image, ImageRegion...

Or you can create make a dedicated section "see also": \sa Image \sa ImageRegion

  • /

template< class T1, typename T2, unsigned int VDimension > class MyAwesomeClass { public:

 /** you can directly write the documentation for PixelType */
 typedef PixelType T1;

}; </source>


List of most common doxygen commands:

Documenting Methods / Functions

Creating links to wiki examples

Documenting modules

Is there a way to create a dependency graph of the modules?

That would be great!! Right now, what's being done is that at cmake time, a doxygen page is generated and at the end of the page you have a "Dependencies" section with the list of dependent modules, and links to corresponding pages.

Maintaining the documentation

Suppressing and preventing Doxygen warnings