<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> <title>Doxygen manual: Lists</title> <link href="doxygen.css" rel="stylesheet" type="text/css"> </head><body> <!-- Generated by Doxygen 1.4.4 --> <h1><a class="anchor" name="lists">Lists</a></h1>Doxygen has a number of ways to create lists of items.<p> <b>Using dashes</b><p> 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: <div class="fragment"><pre class="fragment"> ! * 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. </pre></div> The result will be:<p> A list of events:<ul> <li>mouse events<ol type=a> <li>mouse move event</li><li>mouse click event<br> More info about the click event.</li><li>mouse double click event</li></ol> </li><li>keyboard events<ol type=a> <li>key down event</li><li>key up event</li></ol> </li></ul> <p> More text here.<p> If you use tabs within lists, please make sure that <a class="el" href="config.html#cfg_tab_size">TAB_SIZE</a> in the configuration file is set to the correct tab size.<p> You can end a list by starting a new paragraph or by putting a dot (.) on an empty line at the same indent level as the list you would like to end.<p> Here is an example that speaks for itself:<p> <div class="fragment"><pre class="fragment">* * Text before the list * - list item 1 * - sub item 1 * - sub sub item 1 * - sub sub item 2 * . * The dot above ends the sub sub item list. * More text for the first sub item * . * The dot above ends the first sub item. * More text for the first list item * - sub item 2 * - sub item 3 * - list item 2 * . * More text in the same paragraph. * * More text in a new paragraph. </pre></div><p> <b>Using HTML commands</b><p> 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 consist of multiple paragraphs.<p> Here is the above example with HTML commands: <div class="fragment"><pre class="fragment"> ! * 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. </pre></div><p> <dl compact><dt><b>Note:</b></dt><dd>The indentation here is not important.</dd></dl> <b>Using \arg or @li</b><p> For compatibility with the Troll Tech's internal documentation tool and with KDoc, doxygen has two commands that can be used to create simple unnested lists.<p> See <a class="el" href="commands.html#cmdarg">\arg</a> and <a class="el" href="commands.html#cmdli">\li</a> for more info.<p> Go to the <a href="grouping.html">next</a> section or return to the <a href="index.html">index</a>. <hr size="1"><address style="align: right;"><small>Generated on Wed Nov 15 11:05:48 2006 for Doxygen manual by <a href="http://www.doxygen.org/index.html"> <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.4 </small></address> </body> </html>
