summaryrefslogtreecommitdiffstats
path: root/doc/lists.doc
blob: eaf86166762749576f5b7d386bc795a762ae925e (plain)
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
85
86
87
88
89
/*! \page lists Lists

Doxygen has a number of ways to create lists of items.

<b>Using dashes</b>

     By putting a number of column-aligned minus signs at the start of a 
     line, a bullet list will automatically be generated. 
     Numbered lists can also be generated by using a minus followed by a hash.
     Nesting of lists is allowed.<p>
     Here is an example:
\verbatim
  /*! 
   *  A list of events:
   *    - mouse events
   *         -# mouse move event
   *         -# mouse click event\n
   *            More info about the click event.
   *         -# mouse double click event
   *    - keyboard events
   *         -# key down event
   *         -# key up event
   *
   *  More text here.
   */
\endverbatim
     The result will be:

     A list of events:
       - mouse events
            -# mouse move event
            -# mouse click event\n
               More info about the click event.
            -# mouse double click event
       - keyboard events
            -# key down event
            -# key up event
     
     More text here.

If you use tabs within lists, please make sure that \ref cfg_tab_size "TAB_SIZE" in the 
configuration file is set to the correct tab size.

<b>Using HTML commands</b>

If you like you can also use HTML commands inside the documentation
blocks. Using these commands has the advantage that it is more natural
for list items that consists of multiple paragraphs. 

Here is the above example with HTML commands:
\verbatim
  /*! 
   *  A list of events:
   *  <ul>
   *  <li> mouse events
   *     <ol>
   *     <li>mouse move event
   *     <li>mouse click event\n
   *         More info about the click event.
   *     <li>mouse double click event
   *     </ol>
   *  <li> keyboard events
   *     <ol>     
   *     <li>key down event
   *     <li>key up event
   *     </ol>
   *  </ul>
   *  More text here.
   */
\endverbatim

\note The the indent here is not important.

<b>Using \\arg or \@li</b>

For compatibility with the Troll Tech's internal documentation tool and
with KDoc, doxygen has two commands that can be used to create simple
not nested lists. 

See \ref cmdarg "\arg" and \ref cmdli "\li" for more info.

\htmlonly
Go to the <a href="grouping.html">next</a> section or return to the
 <a href="index.html">index</a>.
\endhtmlonly

*/