commands.doc

doxygen(一个自动从源代码生成文档的工具)的源代码

\subsection cmda \a <word>
 
  \addindex \a
  Displays the argument \<word\> using a special font.
  Use this command to refer to member arguments in the running text.

  \par Example:
  \verbatim
  ... the \a x and \a y coordinates are used to ...
  \endverbatim 
  This will result in the following text:<br><br>
  ... the \a x and \a y coordinates are used to ...

<hr>
\subsection cmdarg \arg { item-description }
  
  \addindex \arg
  This command has one argument that continues until the first
  blank line or until another \\arg is encountered.
  The command can be used to generate a simple, not nested list of
  arguments. 
  Each argument should start with a \\arg command.
  
  \par Example:
  Typing:
  \verbatim
  \arg \c AlignLeft left alignment.
  \arg \c AlignCenter center alignment.
  \arg \c AlignRight right alignment
  
  No other types of alignment are supported.
  \endverbatim
  will result in the following text:<br><br>
  <ul>
  <li> \c AlignLeft left alignment.
  <li> \c AlignCenter center alignment.
  <li> \c AlignRight right alignment
  </ul><br>
  No other types of alignment are supported.

  \par Note:
  For nested lists, HTML commands should be used.

  Equivalent to \ref cmdli "\\li"


<hr>
\subsection cmdb \b <word>

  \addindex \b
  Displays the argument \<word\> using a bold font.
  Equivalent to \<b\>word\</b\>.
  
<hr>
\subsection cmdc \c <word>

  \addindex \c
  Displays the argument \<word\> using a typewriter font.
  Use this to refer to a word of code.
  Equivalent to \<tt\>word\</tt\>.

  \par Example:
  Typing:
  \verbatim
     ... This function returns \c void and not \c int ...
  \endverbatim
  will result in the following text:<br><br>
     ... This function returns \c void and not \c int ...

  Equivalent to \ref cmdp "\\p"

<hr>
\subsection cmdcode \code

  \addindex \code
  Starts a block of code. A code block is treated differently
  from ordinary text. It is interpreted as C/C++ code. The names of the
  classes and members that are documented are automatically replaced by 
  links to the documentation. 

  \sa section \ref cmdendcode "\\endcode", section \ref cmdverbatim "\\verbatim"  

<hr>
\subsection cmddotfile \dotfile <file> ["caption"] 

  \addindex \dotfile
  Inserts an image generated by dot from \<file\> into the documentation. 

  The first argument specifies the file name of the image. 
  doxygen will look for files in the paths (or files) that you specified 
  after the \ref cfg_dotfile_dirs "DOTFILE_DIRS" tag. 
  If the dot file is found it will be used as an input file to the dot tool. 
  The resulting image will be put into the correct output directory.
  If the dot file name contains spaces you'll have to put quotes (") around it.

  The second argument is optional and can be used to specify the caption
  that is displayed below the image. This argument has to be specified
  between quotes even if it does not contain any spaces. The quotes are
  stripped before the caption is displayed.

<hr>
\subsection cmde \e <word>

  \addindex \e 
  Displays the argument \<word\> in italics.
  Use this command to emphasize words.

  \par Example:
  Typing:
  \verbatim
  ... this is a \e really good example ... 
  \endverbatim
  will result in the following text:<br><br>
  ... this is a \e really good example ...

  Equivalent to \ref cmdem "\\em"

<hr>
\subsection cmdem \em <word>

  \addindex \e 
  Displays the argument \<word\> in italics.
  Use this command to emphasize words.

  \par Example:
  Typing:
  \verbatim
  ... this is a \em really good example ... 
  \endverbatim
  will result in the following text:<br><br>
  ... this is a \em really good example ...

  Equivalent to \ref cmde "\\e"

<hr>
\subsection cmdendcode \endcode

  \addindex \endcode
  Ends a block of code.
  \sa section \ref cmdcode "\\code"
 
<hr>
\subsection cmdendhtmlonly \endhtmlonly

  \addindex \endhtmlonly
  Ends a block of text that was started with a \\htmlonly command.

  \sa section \ref cmdhtmlonly "\\htmlonly".

<hr>
\subsection cmdendlatexonly \endlatexonly

  \addindex \endlatexonly
  Ends a block of text that was started with a \\latexonly command.

  \sa section \ref cmdlatexonly "\\latexonly".

<hr>
\subsection cmdendverbatim \endverbatim

  \addindex \endverbatim
  Ends a block of text that was started with a \\verbatim command.
  
  \sa section \ref cmdverbatim "\\verbatim".

<hr>
\subsection cmdfdollar \f$

  \addindex \f$

  Marks the start and end of an in-text formula. 
  \sa section \ref formulas "formulas" for an example.
  
<hr>
\subsection cmdfbropen \f[

  \addindex \f[

  Marks the start of a long formula that is displayed 
  centered on a separate line.
  \sa section \ref cmdfbrclose "\\f]" and section \ref formulas "formulas".

<hr>
\subsection cmdfbrclose \f]

  \addindex \f]
  
  Marks the end of a long formula that is displayed
  centered on a separate line.
  \sa section \ref cmdfbropen ""\\f[" and section \ref formulas "formulas".

<hr>
\subsection cmdhtmlonly \htmlonly

  \addindex \htmlonly
  Starts a block of text that will be verbatim included in the
  generated HTML documentation only. The block ends with a
  endhtmlonly command.

  This command can be used to include HTML code that is too complex
  for doxygen (i.e. applets, java-scripts, and HTML tags that
  require attributes). You can use the \\latexonly and \\endlatexonly
  pair to provide a proper \f$\mbox{\LaTeX}\f$ alternative.

  \b Note:
    environment variables (like \$(HOME) ) are resolved inside a 
    HTML-only block.

  \sa section \ref cmdhtmlonly "\\htmlonly" and section 
              \ref cmdlatexonly "\\latexonly".

<hr>
\subsection cmdimage \image <format> <file> ["caption"] [<sizeindication>=<size>]

  \addindex \image
  Inserts an image into the documentation. This command is format
  specific, so if you want to insert an image for more than one
  format you'll have to repeat this command for each format.

  The first argument specifies the output format. Currently, the 
  following values are supported: \c html and \c latex.
  
  The second argument specifies the file name of the image. 
  doxygen will look for files in the paths (or files) that you specified 
  after the \ref cfg_image_path "IMAGE_PATH" tag. 
  If the image is found it will be copied to the correct output directory.
  If the image name contains spaces you'll have to put quotes (") around it.
  You can also specify an absolute URL instead of a file name, but then
  doxygen does not copy the image nor check its existance.

  The third argument is optional and can be used to specify the caption
  that is displayed below the image. This argument has to be specified
  between quotes even if it does not contain any spaces. The quotes are
  stripped before the caption is displayed.

  The fourth argument is also optional and can be used to specify the 
  width or height of the image. This is only useful 
  for \f$\mbox{\LaTeX}\f$ output
  (i.e. format=<code>latex</code>). The \c sizeindication can be 
  either \c width or \c height. The size should be a valid 
  size specifier in \f$\mbox{\LaTeX}\f$ (for example <code>10cm</code> or 
  <code>6in</code> or a symbolic width like <code>\\textwidth</code>).

  Here is example of a comment block:

\verbatim
  /*! Here is a snapshot of my new application:
   *  \image html application.jpg
   *  \image latex application.eps "My application" width=10cm
   */
\endverbatim

  And this is an example of how the relevant part of the configuration file 
  may look:

\verbatim
  IMAGE_PATH     = my_image_dir
\endverbatim

  \warning The image format for HTML is limited to what your
           browser supports. For \f$\mbox{\LaTeX}\f$ the image format
           must be Encapsulated PostScript (eps).
           <br><br>
           Doxygen does not check if the image is in the correct format. 
           So \e you have to make sure this is the case!

<hr>
\subsection cmdlatexonly \latexonly

  \addindex \latexonly
  Starts a block of text that will be verbatim included in the
  generated \f$\mbox{\LaTeX}\f$ documentation only. The block ends with a
  endlatexonly command.

  This command can be used to include \f$\mbox{\LaTeX}\f$ code that is too 
  complex for doxygen (i.e. images, formulas, special characters). You can 
  use the \\htmlonly and \\endhtmlonly pair to provide a proper HTML 
  alternative.

  \b Note:
    environment variables (like \$(HOME) ) are resolved inside a 
    \f$\mbox{\LaTeX}\f$-only block.

  \sa section \ref cmdlatexonly "\\latexonly" 
  and section \ref cmdhtmlonly "\\htmlonly".

<hr>
\subsection cmdli \li { item-description }
  
  \addindex \li
  This command has one argument that continues until the first
  blank line or until another \\li is encountered.
  The command can be used to generate a simple, not nested list of
  arguments. 
  Each argument should start with a \\li command.
  
  \par Example:
  Typing:
  \verbatim
  \li \c AlignLeft left alignment.
  \li \c AlignCenter center alignment.
  \li \c AlignRight right alignment
  
  No other types of alignment are supported.
  \endverbatim
  will result in the following text:<br><br>
  <ul>
  <li> \c AlignLeft left alignment.
  <li> \c AlignCenter center alignment.
  <li> \c AlignRight right alignment
  </ul><br>
  No other types of alignment are supported.

  \par Note:
  For nested lists, HTML commands should be used.

  Equivalent to \ref cmdarg "\\arg"

<hr>
\subsection cmdp \p <word>
 
  \addindex \p
  Displays the parameter \<word\> using a typewriter font.
  You can use this command to refer to member function parameters in 
  the running text.

  \par Example:
  \verbatim
  ... the \p x and \p y coordinates are used to ...
  \endverbatim 
  This will result in the following text:<br><br>
  ... the \p x and \p y coordinates are used to ...

  Equivalent to \ref cmdc "\\c"
 
<hr>
\subsection cmdverbatim \verbatim

  \addindex \verbatim
  Starts a block of text that will be verbatim included in both the
  HTML and the 
  \f$\mbox{\LaTeX}\f$ documentation. The block should end with a 
  \\endverbatim block. All commands are disabled in a verbatim block.

  \warning Make sure you include a \\endverbatim command for each 
  \\verbatim command or the parser will get confused!

<hr>
\subsection cmdbackslash \\

  \addindex \\
  This command writes a backslash character (\\) to the HTML and 
  \f$\mbox{\LaTeX}\f$ output. The backslash has to be escaped in some 
  cases because doxygen uses it to detect commands.

<hr>
\subsection cmdat \@

  \addindex \@
  This command writes an at-sign (@) to the HTML and 
  \f$\mbox{\LaTeX}\f$ output. The at-sign has to be escaped in some cases 
  because doxygen uses it to detect JavaDoc commands.

<hr>
\subsection cmdamp \&

  \addindex \&
  This command writes the \& character to the HTML and 
  \f$\mbox{\LaTeX}\f$ output. This character has to be escaped because 
  it has a special meaning in HTML.

<hr>
\subsection cmddollar \$

  \addindex \$
  This command writes the \$ character to the HTML and 
  \f$\mbox{\LaTeX}\f$ output. This 
  character has to be escaped in some cases, because it is used to expand 
  environment variables.

<hr>
\subsection cmdhash \#

  \addindex \#
  This command writes the \# character to the HTML and 
  \f$\mbox{\LaTeX}\f$ output. This 
  character has to be escaped in some cases, because it is used to refer
  to documented entities. 

<hr>
\subsection cmdlt \\<

  \addindex \\<
  This command writes the \< character to the HTML and 
  \f$\mbox{\LaTeX}\f$ output. This 
  character has to be escaped because it has a special meaning in HTML.

<hr>
\subsection cmdgt \\>

  \addindex \\>
  This command writes the \> character to the HTML and 
  \f$\mbox{\LaTeX}\f$ output. This 
  character has to be escaped because it has a special meaning in HTML.

<hr>
<h2>\htmlonly <center> --- \endhtmlonly 
    Commands included for Qt compatibility
    \htmlonly --- </center>\endhtmlonly</h2>

The following commands are supported to remain compatible to the Qt class
browser generator. Do \e not use these commands in your own documentation.
<ul>
<li>\\annotatedclasslist
<li>\\classhierarchy
<li>\\define
<li>\\functionindex
<li>\\header
<li>\\headerfilelist
<li>\\inherit
<li>\\l
<li>\\postheader
</ul>

*/