News:

When registered with our forums, feel free to send a "here I am" post here to differ human beings from SPAM bots.

Main Menu

enable JAVADOC_AUTOBRIEF in doxygen style document generation option

Started by ollydbg, June 27, 2015, 03:23:38 PM

Previous topic - Next topic

ollydbg

Hi, alpha, I see that we have many doxygen style document in our C::B source, which only have one line before the function
Such as in include\projectfile.h (also there are many in CodeCompletion document).

...
        /** The weight. This is a number between 0 and 100 (defaults to 50).
          * Files with smaller weights are compiled earlier than those with larger weights. */
        unsigned short int weight;

        /** If true, the file is open inside an editor. */
        bool editorOpen; // layout info

        /** Split type of the editor as int. */
        int editorSplit; // layout info

        /** Last active splitview (1 or 2). */
        int editorSplitActive; // layout info

        /** Last splitter position. */
        int editorSplitPos; // layout info

        /** The last known caret position in an editor for this file (left/top control if split). */
        int editorPos; // layout info

        /** The last known caret line in an editor for this file (left/top control if split). */
        int editorTopLine; // layout info
...


So, when generate the http://alpha0010.github.io, I strongly suggest enable this option, so that the first line is used as the brief of the function document.
If some piece of memory should be reused, turn them to variables (or const variables).
If some piece of operations should be reused, turn them to functions.
If they happened together, then turn them to classes.

Alpha

Testing it out.  Unfortunately enabling this exposes a doxygen bug where it generates invalid xhtml.  I will see if I can easily patch doxygen... if not, I will change file extensions to html (sorry IE users, no graphs for you), though I would like to avoid breaking links like that.

Alpha

Done; links broken.  (If trying to find a page, delete the file extension, and it should work.)

oBFusCATed

I don't know if it is only on my computer, but this link http://alpha0010.github.io/ doesn't work.
It shows the page not found message.
(most of the time I ignore long posts)
[strangers don't send me private messages, I'll ignore them; post a topic in the forum, but first read the rules!]


ollydbg

Quote from: Alpha on June 27, 2015, 10:08:07 PM
Done; links broken.  (If trying to find a page, delete the file extension, and it should work.)
Thanks!
If some piece of memory should be reused, turn them to variables (or const variables).
If some piece of operations should be reused, turn them to functions.
If they happened together, then turn them to classes.