summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDimitri van Heesch <dimitri@stack.nl>2008-12-25 20:54:44 (GMT)
committerDimitri van Heesch <dimitri@stack.nl>2008-12-25 20:54:44 (GMT)
commit5b3f3dc61bad158050a2953728f87a9a411823e2 (patch)
tree64b7da0b56bbee19e999a23f69d13372807211d5 /doc
parentb2ff175fbaa113d17cc8c0873220580df1887b97 (diff)
downloadDoxygen-5b3f3dc61bad158050a2953728f87a9a411823e2.zip
Doxygen-5b3f3dc61bad158050a2953728f87a9a411823e2.tar.gz
Doxygen-5b3f3dc61bad158050a2953728f87a9a411823e2.tar.bz2
Release-1.5.7.1-20081225
Diffstat (limited to 'doc')
-rw-r--r--doc/commands.doc91
-rw-r--r--doc/docblocks.doc14
-rw-r--r--doc/language.doc4
-rw-r--r--doc/output.doc1
4 files changed, 85 insertions, 25 deletions
diff --git a/doc/commands.doc b/doc/commands.doc
index 7450d91..4d8e5f7 100644
--- a/doc/commands.doc
+++ b/doc/commands.doc
@@ -127,14 +127,14 @@ documentation:
\refitem cmdparam \\param
\refitem cmdpost \\post
\refitem cmdpre \\pre
-\refitem cmd_php_only \\private (PHP only)
-\refitem cmd_php_only \\privatesection (PHP only)
+\refitem cmdprivate \\private
+\refitem cmdprivate \\privatesection
\refitem cmdproperty \\property
-\refitem cmd_php_only \\protected (PHP only)
-\refitem cmd_php_only \\protectedsection (PHP only)
+\refitem cmdprotected \\protected
+\refitem cmdprotected \\protectedsection
\refitem cmdprotocol \\protocol
-\refitem cmd_php_only \\public (PHP only)
-\refitem cmd_php_only \\publicsection (PHP only)
+\refitem cmdpublic \\public
+\refitem cmdpublic \\publicsection
\refitem cmdref \\ref
\refitem cmdrelates \\relates
\refitem cmdrelatesalso \\relatesalso
@@ -575,6 +575,10 @@ doxygen. Unrecognized commands are treated as normal text.
is represented as a real member of the class.
This can be useful when the programming language does not support
the concept of member functions natively (e.g. C).
+
+ It is also possible to use this command together with
+ \ref cmdpublic "\\public", \ref cmdprotected "\\protected" or
+ \ref cmdprivate "\\private".
The file \c manual.c in the example directory shows how to use this command.
\htmlonly
@@ -582,8 +586,9 @@ doxygen. Unrecognized commands are treated as normal text.
for the corresponding HTML documentation that is generated by doxygen.
\endhtmlonly
- \sa section \ref cmdextends "\\extends" and section
- \ref cmdmemberof "\\memberof"
+ \sa sections \ref cmdextends "\\extends", \ref cmdimplements "\\implements",
+ \ref cmdpublic "\\public", \ref cmdprotected "\\protected" and
+ \ref cmdprivate "\\private".
<hr>
\section cmdname \\name (header)
@@ -683,6 +688,25 @@ doxygen. Unrecognized commands are treated as normal text.
\ref cmdref "\\ref".
<hr>
+\section cmdprivate \\private
+
+ \addindex \\private
+ \addindex \\privatesection
+ Indicates that the member documented in the comment block is private,
+ i.e., should only be accessed by other members in the same class.
+
+ Note that Doxygen automatically detects the protection level of members
+ in object-oriented languages. This command is intended for use only when
+ the language does not support the concept of protection level natively
+ (e.g. C, PHP 4).
+
+ For starting a section of private members, in a way similar to the
+ "private:" class marker in C++, use \\privatesection.
+
+ \sa sections \ref cmdmemberof "\\memberof", \ref cmdpublic "\\public",
+ and \ref cmdprotected "\\protected".
+
+<hr>
\section cmdproperty \\property (qualified property name)
\addindex \\property
@@ -693,6 +717,26 @@ doxygen. Unrecognized commands are treated as normal text.
\sa section \ref cmdfn "\\fn" and \ref cmdvar "\\var".
<hr>
+\section cmdprotected \\protected
+
+ \addindex \\protected
+ \addindex \\protectedsection
+ Indicates that the member documented in the comment block is protected,
+ i.e., should only be accessed by other members in the same or derived
+ classes.
+
+ Note that Doxygen automatically detects the protection level of members
+ in object-oriented languages. This command is intended for use only when
+ the language does not support the concept of protection level natively
+ (e.g. C, PHP 4).
+
+ For starting a section of protected members, in a way similar to the
+ "protected:" class marker in C++, use \\protectedsection.
+
+ \sa sections \ref cmdmemberof "\\memberof", \ref cmdpublic "\\public",
+ and \ref cmdprivate "\\private".
+
+<hr>
\section cmdprotocol \\protocol <name> [<header-file>] [<header-name>]
\addindex \\protocol
@@ -703,6 +747,25 @@ doxygen. Unrecognized commands are treated as normal text.
\sa section \ref cmdclass "\\class".
<hr>
+\section cmdpublic \\public
+
+ \addindex \\public
+ \addindex \\publicsection
+ Indicates that the member documented in the comment block is public,
+ i.e., can be accessed by any other class or function.
+
+ Note that Doxygen automatically detects the protection level of members
+ in object-oriented languages. This command is intended for use only when
+ the language does not support the concept of protection level natively
+ (e.g. C, PHP 4).
+
+ For starting a section of public members, in a way similar to the
+ "public:" class marker in C++, use \\publicsection.
+
+ \sa sections \ref cmdmemberof "\\memberof", \ref cmdprotected "\\protected"
+ and \ref cmdprivate "\\private".
+
+<hr>
\section cmdrelates \\relates <name>
\addindex \\relates
@@ -2369,18 +2432,6 @@ class Receiver
character has to be escaped in some cases, because it is used to
prevent auto-linking to word that is also a documented class or struct.
-<hr>
-\section cmd_php_only PHP only commands
-For PHP files there are a number of additional commands, that can be
-used inside classes to make members public, private, or protected even
-though the language itself doesn't support this notion.
-
-To mark a single item use one of \\private, \\protected, \\public.
-For starting a section with a certain protection level use one of:
-\\privatesection, \\protectedsection, \\publicsection.
-The latter commands are similar to
-"private:", "protected:", and "public:" in C++.
-
<h2>\htmlonly <center> --- \endhtmlonly
Commands included for Qt compatibility
\htmlonly --- </center>\endhtmlonly</h2>
diff --git a/doc/docblocks.doc b/doc/docblocks.doc
index 0e9f38e..8ac55bb 100644
--- a/doc/docblocks.doc
+++ b/doc/docblocks.doc
@@ -238,7 +238,8 @@ If you want to document the members of a file, struct, union, class, or enum,
and you want to put the documentation for these members inside the compound,
it is sometimes desired to place the documentation block after the member
instead of before. For this purpose you have to put an additional \< marker
-in the comment block. Note that this also works for the parameters of a function.
+in the comment block. Note that this also works for the parameters
+of a function.
Here are some examples:
\verbatim
@@ -271,6 +272,14 @@ or
int var; ///< Brief description after the member
\endverbatim
+For functions one can use \@param to document the parameters
+and then use <code>[in]</code>, <code>[out]</code>, <code>[in,out]</code>
+to document the direction. For inline documentation this is also possible
+by starting with the direction attribute, e.g.
+\verbatim
+void foo(int v /**< [in] docs for input parameter v. */);
+\endverbatim
+
Note that these blocks have the same structure and meaning as the
special comment blocks in the previous section
only the \< indicates that the member is
@@ -287,7 +296,8 @@ Here is an example of the use of these comment blocks:
They cannot be used to document files, classes, unions, structs,
groups, namespaces and enums themselves. Furthermore, the structural
commands mentioned in the next section
- (like <code>\\class</code>) are ignored inside these comment blocks.
+ (like <code>\\class</code>) are not allowed
+ inside these comment blocks.
\section structuralcommands Documentation at other places
diff --git a/doc/language.doc b/doc/language.doc
index 65311ff..e5e3774 100644
--- a/doc/language.doc
+++ b/doc/language.doc
@@ -420,10 +420,10 @@ Just follow these steps:
at two places in the script:
<ol>
<li>After the <code>f_langs=</code> is statement, in lower case.
- <li>In the string that following <code>@allowed=</code> in upper case.
+ <li>In the string that following <code>\@allowed=</code> in upper case.
</ol>
The rerun the configure script such that is generates src/lang_cfg.h.
-This file should now contain a #define for your language code.
+This file should now contain a \#define for your language code.
<li>Edit language.cpp:
Add a
\verbatim
diff --git a/doc/output.doc b/doc/output.doc
index 5777ca2..6e37f91 100644
--- a/doc/output.doc
+++ b/doc/output.doc
@@ -34,7 +34,6 @@ The following output formats are \e directly supported by doxygen:
Word 97. If you have success with other programs, please let me know.
<dt><b>XML</b>
<dd>Generated if \c GENERATE_XML is set to \c YES in the configuration file.<p>
- Note that the XML output is still under development.
<dt><b>Qt Help Project (.qhp)</b>
<dd>Generated if \c GENERATE_QHP is set to \c YES in the configuration file.
</dl>