summaryrefslogtreecommitdiffstats
path: root/doc/htmlcmds.doc
blob: 96b22f5b1d13126c1858af46d33d4e45b88637c2 (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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
/******************************************************************************
 *
 * 
 *
 * Copyright (C) 1997-2002 by Dimitri van Heesch.
 *
 * Permission to use, copy, modify, and distribute this software and its
 * documentation under the terms of the GNU General Public License is hereby 
 * granted. No representations are made about the suitability of this software 
 * for any purpose. It is provided "as is" without express or implied warranty.
 * See the GNU General Public License for more details.
 *
 * Documents produced by Doxygen are derivative works derived from the
 * input used in their production; they are not affected by this license.
 *
 */
/*! \page htmlcmds HTML Commands

Here is a list of all HTML commands that may be used inside the
documentation. Note that all attributes of a HTML tag are ignored 
(the HREF and NAME attributes for the A tag are the only exception).

<ul>
<li><tt>\<A HREF="..."\></tt> Starts a HTML hyper-link (HTML only). 
<li><tt>\<A NAME="..."\></tt> Starts an named anchor (HTML only).
<li><tt>\</A\></tt>    Ends a link or anchor (HTML only).
<li><tt>\<B\></tt>     Starts a piece of text displayed in a bold font.
<li><tt>\</B\></tt>    Ends a <tt>\<B\></tt> section.
<li><tt>\<BODY\></tt>  Does not generate any output.
<li><tt>\</BODY\></tt> Does not generate any output.
<li><tt>\<BR\></tt>    Forces a line break.
<li><tt>\<CENTER\></tt> starts a section of centered text.
<li><tt>\</CENTER\></tt> ends a section of centered text.
<li><tt>\<CAPTION\></tt> Starts a caption. Use within a table only.
<li><tt>\</CAPTION\></tt> Ends a caption. Use within a table only.
<li><tt>\<CODE\></tt>  Starts a piece of text displayed in a typewriter font.
<li><tt>\</CODE\></tt> End a <tt>\<CODE\></tt> section.
<li><tt>\<DD\></tt>    Starts an item description.
<li><tt>\<DFN\></tt>   Starts a piece of text displayed in a typewriter font.
<li><tt>\</DFN\></tt>  Ends a <tt>\<DFN\></tt> section.
<li><tt>\<DL\></tt>    Starts a description list.
<li><tt>\</DL\></tt>   Ends a description list.
<li><tt>\<DT\></tt>    Starts an item title.
<li><tt>\</DT\></tt>   Ends an item title.
<li><tt>\<EM\></tt>    Starts a piece of text displayed in an italic font.
<li><tt>\</EM\></tt>   Ends a <tt>\<EM\></tt> section.
<li><tt>\<FORM\></tt>  Does not generate any output.
<li><tt>\</FORM\></tt> Does not generate any output.
<li><tt>\<HR\></tt>    Writes a horizontal ruler.
<li><tt>\<H1\></tt>    Starts an unnumbered section.
<li><tt>\</H1\></tt>   Ends an unnumberd section.
<li><tt>\<H2\></tt>    Starts an unnumbered subsection.
<li><tt>\</H2\></tt>   Ends an unnumbered subsection.
<li><tt>\<H3\></tt>    Starts an unnumbered subsubsection.
<li><tt>\</H3\></tt>   Ends an unnumbered subsubsection.
<li><tt>\<I\></tt>     Starts a piece of text displayed in an italic font.
<li><tt>\<INPUT\></tt> Does not generate any output.
<li><tt>\</I\></tt>    Ends a <tt>\<I\></tt> section.
<li><tt>\<IMG\></tt>   This command is written with attributes to the HTML output only.
<li><tt>\<LI\></tt>    Starts a new list item.
<li><tt>\</LI\></tt>   Ends a list item.
<li><tt>\<META\></tt>  Does not generate any output.
<li><tt>\<MULTICOL\></tt> ignored by doxygen.
<li><tt>\</MUTLICOL\></tt> ignored by doxygen.
<li><tt>\<OL\></tt>    Starts a numbered item list.
<li><tt>\</OL\></tt>   Ends a numbered item list.
<li><tt>\<P\></tt>     Starts a new paragraph.
<li><tt>\</P\></tt>    Ends a paragraph.
<li><tt>\<PRE\></tt>   Starts a preformatted fragment.
<li><tt>\</PRE\></tt>  Ends a preformatted fragment.
<li><tt>\<SMALL\></tt> Starts a section of text displayed in a smaller font.
<li><tt>\</SMALL\></tt> Ends a <tt>\<SMALL\></tt> section.
<li><tt>\<STRONG\></tt> Starts a section of bold text.
<li><tt>\</STRONG\></tt> Ends a section of bold text.
<li><tt>\<SUB\></tt>   Starts a piece of text displayed in subscript.
<li><tt>\</SUB\></tt>  Ends a <tt>\<SUB\></tt> section.
<li><tt>\<SUP\></tt>   Starts a piece of text displayed in superscript.
<li><tt>\</SUP\></tt>  Ends a <tt>\</SUP\></tt> section.
<li><tt>\<TABLE\></tt> starts a table.
<li><tt>\</TABLE\></tt> ends a table.
<li><tt>\<TD\></tt>    Starts a new table data element.
<li><tt>\</TD\></tt>   Ends a table data element.
<li><tt>\<TR\></tt>    Starts a new table row.
<li><tt>\</TR\></tt>   Ends a table row.
<li><tt>\<TT\></tt>    Starts a piece of text displayed in a typewriter font.
<li><tt>\</TT\></tt>   Ends a <tt>\<TT\></tt> section.
<li><tt>\<KBD\></tt>   Starts a piece of text displayed in a typewriter font.
<li><tt>\</KBD\></tt>  Ends a <tt>\<KBD\></tt> section.
<li><tt>\<UL\></tt>    Starts an unnumbered item list.
<li><tt>\</UL\></tt>   Ends an unnumbered item list.
<li><tt>\<VAR\></tt>   Starts a piece of text displayed in an italic font.
<li><tt>\</VAR\></tt>  Ends a <tt>\</VAR\></tt> section.
</ul>

The special HTML character entities that are recognized by Doxygen:

<ul>
<li><tt>\&copy;</tt> the copyright symbol
<li><tt>\&quot;</tt> a double quote
<li><tt>\&?uml;</tt>   where ? is one of {A,E,I,O,U,Y,a,e,i,o,u,y}, 
       writes a character with a diaeresis accent (like &auml;).
<li><tt>\&?acute;</tt> where ? is one of {A,E,I,O,U,Y,a,e,i,o,u,y},
       writes a character with a acute accent (like &aacute;). 
<li><tt>\&?grave;</tt> where ? is one of {A,E,I,O,U,a,e,i,o,u,y},
       writes a character with a grave accent (like &agrave;).
<li><tt>\&?circ;</tt>  where ? is one of {A,E,I,O,U,a,e,i,o,u,y},
       writes a character with a circumflex accent (like &acirc;).
<li><tt>\&?tilde;</tt> where ? is one of {A,N,O,a,n,o},
       writes a character with a tilde accent (like &atilde;).
<li><tt>\&szlig;</tt> write a sharp s (i.e. &szlig;) to the output.
<li><tt>\&?cedil;</tt> where ? is one of {c,C},
       writes a c-cedille (like &ccedil;).
<li><tt>\&?ring;</tt> where ? is one of {a,A},
       writes an <tt>a</tt> with a ring (like &aring;).
<li><tt>\&nbsp;</tt> a non breakable space.
</ul>

Finally, to put invisible comments inside comment blocks, HTML style
comments can be used:
\verbatim
/*! <!-- This is a comment with a comment block --> Visible text */
\endverbatim

*/