|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /proc/22697/root/usr/share/doc/doxygen-1.4.7/html/ |
Upload File : |
<!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: XML Commands</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.4.7 -->
<h1><a class="anchor" name="xmlcmds">XML Commands</a></h1>Doxygen supports most of the XML commands that are typically used in C# code comments. The XML tags are defined in Appendix E of the <a href="http://www.ecma-international.org/publications/standards/Ecma-334.htm">ECMA-334</a> standard, which defines the C# language. Unfortunately, the specification is not very precise and a number of the examples given are of poor quality.<p>
Here is the list of tags supported by doxygen:<p>
<ul>
<li>
<code><c></code> Identifies inline text that should be rendered as a piece of code. Similar to using <code><tt></code>text<code></tt></code>. </li>
<li>
<code><code></code> Set one or more lines of source code or program output. Note that this command behaves like <code>\code ... \endcode</code> for C# code, but it behaves like the HTML equivalent <code><code>...</code></code> for other languages. </li>
<li>
<code><description></code> Part of a <code><list></code> command, describes an item. </li>
<li>
<code><example></code> Marks a block of text as an example, ignored by doxygen. </li>
<li>
<code><exception cref="member"></code> Identifies the exception a method can throw. </li>
<li>
<code><include></code> Can be used to import a piece of XML from an external file. Ignored by doxygen at the moment. </li>
<li>
<code><item></code> List item. Can only be used inside a <code><list></code> context. </li>
<li>
<code><list type="type"></code> Starts a list, supported types are <code>bullet</code> or <code>number</code>. A list consists of a number of <code><item></code> tags. </li>
<li>
<code><para></code> Identifies a paragraph of text. </li>
<li>
<code><param name="paramName"></code> Marks a piece of text as the documentation for parameter "paramName". Similar to using <a class="el" href="commands.html#cmdparam">\param</a>. </li>
<li>
<code><paramref name="paramName"></code> Refers to a parameter with name "paramName". Similar to using <a class="el" href="commands.html#cmda">\a</a>. </li>
<li>
<code><permission></code> Identifies the security accessibility of a member. Ignored by doygen. </li>
<li>
<code><remarks></code> Identifies the detailed description. </li>
<li>
<code><returns></code> Marks a piece of text as the return value of a function or method. Similar to using <a class="el" href="commands.html#cmdreturn">\return</a>. </li>
<li>
<code><see cref="member"></code> Refers to a member. Similar to <a class="el" href="commands.html#cmdref">\ref</a>. </li>
<li>
<code><seealso cref="member"></code> Starts a "See also" section referring to "member". Similar to using <a class="el" href="commands.html#cmdsa">\sa</a> member. </li>
<li>
<code><summary></code> Identifies the brief description. Similar to using <a class="el" href="commands.html#cmdbrief">\brief</a>. </li>
<li>
<code><value></code> Identifies a property. Ignored by doxygen. </li>
</ul>
<p>
Here is an example of a typical piece of code using some of the above commands:<p>
<div class="fragment"><pre class="fragment"><span class="comment">/// <summary></span>
<span class="comment"></span><span class="comment">/// A search engine.</span>
<span class="comment"></span><span class="comment">/// </summary></span>
<span class="comment"></span><span class="keyword">class </span>Engine
{<span class="comment"></span>
<span class="comment"> /// <summary></span>
<span class="comment"> /// The Search method takes a series of parameters to specify the search criterion</span>
<span class="comment"> /// and returns a dataset containing the result set.</span>
<span class="comment"> /// </summary></span>
<span class="comment"> /// <param name="connectionString">the connection string to connect to the</span>
<span class="comment"> /// database holding the content to search</param></span>
<span class="comment"> /// <param name="maxRows">The maximum number of rows to</span>
<span class="comment"> /// return in the result set</param></span>
<span class="comment"> /// <param name="searchString">The text that we are searching for</param></span>
<span class="comment"> /// <returns>A DataSet instance containing the matching rows. It contains a maximum</span>
<span class="comment"> /// number of rows specified by the maxRows parameter</returns></span>
<span class="comment"></span> <span class="keyword">public</span> DataSet Search(string connectionString, <span class="keywordtype">int</span> maxRows, <span class="keywordtype">int</span> searchString)
{
DataSet ds = <span class="keyword">new</span> DataSet();
<span class="keywordflow">return</span> ds;
}
}
</pre></div> <hr size="1"><address style="align: right;"><small>Generated on 11 Jun 2012 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.7 </small></address>
</body>
</html>