forked from USNavalResearchLaboratory/mgen
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
executable file
·84 lines (65 loc) · 2.42 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
Generating doxygen output on Windows:
1. Make sure the doc/doxy-config file points to the correct location
of graphwiz's "dot" exectuable for your system. (DOT_PATH variable)
2. Load the doxygen configuration file (doc/doxy-config) into the
doxygen wizard.
3. Start, output will be put in /doc/html.
Generating doxygen output on Linux:
1. Make sure the doc/doxy-config file points to the correct location of
graphwiz's "dot" exectuable for your system. (DOT_PATH variable)
2. Run "doxygen doxy-config", output will be put in /doc/html
-------------------------------------------------------------------------
How to document classes:
/**
* @class ClassName
*
* @brief Enter a brief description of the
* class, the first sentence
* will be included in the brief description.
*
* Anything after the first sentence, and included
* in the "@class" block will be part of the
* detailed description, available from
* the doxygen class file.
*
* The "@brief" description will be used to
* describe the class on the class list.
*
*/
How to document functions:
/**
*
* @brief Description of the function. Will appear before function
* definition. Don't really need "@brief" as JAVADOC_AUTOBRIEF is
* turned on.
*
* @param Defailed parameter text, if needed. Will appear in
* separate parameter secion.
*
* @retval Detailed text about return value, if needed.
*
*/
Other Notes:
1. Sometimes the html directory has to be cleared out and the entire
doxygen output regenerated if the graphics get screwed up.
2. Need "dot" from graphwiz. In some doxygen implementations it is
included.
3. Can generate called/call graphs. To enable or disable call graphs
for each function, toggle CALL_GRAPH and CALLER_GRAPH variables in the
config file. To enable for specific functions when CALL_GRAPH is set
to no, use the @callgraph/@callergraph commands.
4. @sa "See also" alias.
@note "Note" alias
@exception
@class
@param
@return
@retval
ProtoGraph::~Vertice has an example of function text and a @note.
5. Can turn off documentation of inherited functions and properties.
8. Modify INPUT in config file to add additional code/directories, e.g.
INPUT = ../common
#Add protolib to the doxygen output
#INPUT += ../../protolib/common
#To add files
#INPUT += ../../protolib/common/protoApp.h ../../protolib/common/protoApp.cpp