Developer forums (C::B DEVELOPMENT STRICTLY!) > Development

enable JAVADOC_AUTOBRIEF in doxygen style document generation option

(1/2) > >>

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).

--- Code: ---...
        /** 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
...

--- End code ---

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.

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.

Alpha:
The link is: http://alpha0010.github.io/cb-docs/

Navigation

[0] Message Index

[#] Next page