Information About

Doxygen




Several projects such as KDE use Doxygen for generating documentation for the API. KDevelop has builtin support for Doxygen.


USAGE

Doxygen takes as input the Source Code files and outputs a set of documentation pages. By default the output format is HTML but it can also be in CHM , RTF , PDF , LaTeX , PostScript or Man Pages .

The documentation generation is based on the parsing of the program structure and on the additional information given by the code writer in specially formated comments. The format of the comments is very similar to Javadoc .


EXAMPLE CODE

The following illustrates how a source file can be documented.

  • ---

  • The time class represents a moment of time.


  • ''\author'' John Doe

  • /

  • class Time {


  • ---

  • Constructor that sets the time to a given value.

  • ''\param'' timemillis Is a number of milliseconds passed since Jan 1. 1970

  • /

  • Time(int timemillis) {

...
}

  • ---

  • Get the current time.

  • '' eturn'' A time object set to the current time.

  • /

  • static Time now() {

...
}
}


VERSIONS

  valign "top"
  valign "top"
  valign "top"
  valign "top"