https://www.fightorder.net/wiki/index.php?action=history&feed=atom&title=Doxygen_style_comments 2026-04-21T04:17:31Z Revision history for this page on the wiki MediaWiki 1.44.2 https://www.fightorder.net/wiki/index.php?title=Doxygen_style_comments&diff=2201&oldid=prev 2026-02-24T06:34:52Z

<p>1 revision imported</p> <table style="background-color: #fff; color: #202122;" data-mw="interface"> <tr class="diff-title" lang="en"> <td colspan="1" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td> <td colspan="1" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 23:34, 23 February 2026</td> </tr><tr><td colspan="2" class="diff-notice" lang="en"><div class="mw-diff-empty">(No difference)</div> </td></tr></table>

Qrow https://www.fightorder.net/wiki/index.php?title=Doxygen_style_comments&diff=2200&oldid=prev 2015-10-11T00:47:18Z

<p></p> <p><b>New page</b></p><div>Spring gets automatically generated documentation for the source code which can be found [https://springrts.com/dl/buildbot/doc/ here]. The tool used for this is [http://www.doxygen.org doxygen]. Whilst doxygen does a good job of producing diagrams and extracting logical relationships from the code, the documentation can be somewhat hard to digest without any descriptive text to read!<br /> <br /> The good news is that doxygen can automatically extract your header comments from the code and use them as a description for the class/method/field they&#039;re associated with... as long as you stick to the doxygen comment style. Therefore, please put doxygen style comments into the code.<br /> <br /> Doxygen comments have the same syntax as Javadoc basically - if you&#039;re familiar with Javadoc, go ahead and write header comments as you normally would in Java. If you&#039;re not familiar with Javadoc, the main thing you need to know is to use:<br /> <br /> /**<br /> <br /> At the start of your comment blocks (doxygen also works with /*!). Or on the otherhand if you prefer using // style comments, use /// or //! as your comment marker.<br /> <br /> Within the comment blocks you can also use [http://www.stack.nl/~dimitri/doxygen/commands.html special commands] including the very useful @todo command. All @todo commands are noted by Doxygen and pulled out into a single &quot;TODO&quot; list page, which lists all the @todo items across the entire project in one place.<br /> <br /> The full [http://www.stack.nl/~dimitri/doxygen/manual.html doxygen manual] describes all the various commenting conventions you can use which doxygen will pick up. This includes nice things like being able to mark several items as having the same comment (part of [http://www.stack.nl/~dimitri/doxygen/grouping.html grouping]), producing [http://www.stack.nl/~dimitri/doxygen/lists.html lists], [http://www.stack.nl/~dimitri/doxygen/autolink.html links] into other classes/methods etc., how to use [http://www.stack.nl/~dimitri/doxygen/htmlcmds.html HTML] within the comments etc.<br /> <br /> The current codebase (0.65b2) contains non doxygen comments as we&#039;ve only just started using it. If you do see header/field comments which start with just /* or //, please do a search-and-replace on them so that we can have the benefit of them in the documentation. Thanks<br /> <br /> [[Category:Engine Dev]]</div>

enginedevinter>Abma