Class Commenting Doxygen for Classes
Structured Comments Structured comments Used for: Machine readable Automatic documentation Tooltips in IDE
Doxygen Format Put /** block comment before function: @brief Description of function @param NAME what parameter called NAME is for @return What is returned @ or \ work the same (@brief or \brief)
File Comments Class header file (.h) get File comment Class comment Author, other stuff? Class comment
Header Comments Header is public interface to our module Where comments go! Comment public interface Anything in public Comment private Functions Variables that are not painfully obvious
File Comments Class implementation (.cpp) gets file comment: Do not duplicate function comments, do comment tricky bits:
File Comments Other cpp files (main) Include file description in file comment If you have global functions, comment those
Using Doxygen http://www.stack.nl/~dimitri/doxygen/ Extract Documentation Builds HTML help file Run HTML opens in browser