• Advertisement
Sign in to follow this  

Advices on code commenting

This topic is 4156 days old which is more than the 365 day threshold we allow for new replies. Please post a new topic.

If you intended to correct an error in the post then please contact us.

Recommended Posts

Hello, In my engine I need to add documentation, in the form of code comments, to all my header files (hundreds of...) The documentation for each function includes a brief description of its usage and of its parameters and return values. Not only functions but other objects like classes have to be commented. Now, since this is a HUGE work to do, before starting I would appreciate the advice of people here on a suggested format. The possibility of automatically extracting a documentation file from the code by parsing the comments is a big bonus.I know .NET promotes in-code documentation in XML format, but I'm also aware of other formats (like the Doxygen one). Any advices on this matter? Thanks a lot, Stefano

Share this post


Link to post
Share on other sites
Advertisement
I've always liked the Javadoc format. It's parseable by Doxygen, Javadoc, and probably other tools as well.
My actual advice: choose a tool you like for documentation extraction, THEN choose a format you like and your tool supports.

Share this post


Link to post
Share on other sites
Guest Anonymous Poster
I comment my code with http://www.naturaldocs.org/

Share this post


Link to post
Share on other sites
Sign in to follow this  

  • Advertisement