comparison DOCS/tech/code-documentation.txt @ 13302:05d3254e05b1

typos, wording

13301:638673d1f83a

Doxygen
-------

MPlayer uses doxygen for its code documentation. It generates HTML files
which contain the specially tagged comment lines from the code including
cross references. To generate it type `make doxygen` in the source root
directory. It will generate the files in DOCS/tech/doxygen. To clear them
again, you can use `make doxygen_clean`.
For further information about doxygen and its sources please have a look
at their website: http://doxygen.sf.net

  * where validity checking is done (optional, mandatory for variables which
    are set by something external, eg user parameters, file information etc)

- #define, typedefs, structs
  * all global definitions
  * all local definitions whos use is not imediatly clear by their name
    (as a rule of thumb, it's better to document too much then not enough)
  * all dependencies

- non-trivial parts of the code
  * tricky parts
  * important parts

13302:05d3254e05b1

Doxygen
-------

MPlayer uses doxygen for its code documentation. It generates HTML files
which contain specially tagged comment lines from the code including
cross references. To generate it type `make doxygen` in the source root
directory. It will generate the files in DOCS/tech/doxygen. To clear them
again, you can use `make doxygen_clean`.
For further information about doxygen and its sources please have a look
at their website: http://doxygen.sf.net

  * where validity checking is done (optional, mandatory for variables which
    are set by something external, eg user parameters, file information etc)

- #define, typedefs, structs
  * all global definitions
  * all local definitions whose use is not imediatly clear by their name
    (as a rule of thumb, it's better to document too much than not enough)
  * all dependencies

- non-trivial parts of the code
  * tricky parts
  * important parts