summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authordimitri <dimitri@afe2bf4a-e733-0410-8a33-86f594647bc7>2000-04-23 18:39:17 (GMT)
committerdimitri <dimitri@afe2bf4a-e733-0410-8a33-86f594647bc7>2000-04-23 18:39:17 (GMT)
commite2b4a623decf7c8b4435f742f05d07323ad8d6f2 (patch)
treeae15def425ebe4c6c13d7b4ffd8e147e03d535b3 /doc
parent0e7fba152ca1c24593a5c9b01460116d16ca3f97 (diff)
downloadDoxygen-e2b4a623decf7c8b4435f742f05d07323ad8d6f2.zip
Doxygen-e2b4a623decf7c8b4435f742f05d07323ad8d6f2.tar.gz
Doxygen-e2b4a623decf7c8b4435f742f05d07323ad8d6f2.tar.bz2
Release-1.1.2-20000423
Diffstat (limited to 'doc')
-rw-r--r--doc/commands.doc68
-rw-r--r--doc/config.doc8
2 files changed, 67 insertions, 9 deletions
diff --git a/doc/commands.doc b/doc/commands.doc
index 87af4ba..c5ca24e 100644
--- a/doc/commands.doc
+++ b/doc/commands.doc
@@ -62,6 +62,7 @@ documentation:
<li> \refitem cmde \e
<li> \refitem cmdendcode \endcode
<li> \refitem cmdendhtmlonly \endhtmlonly
+<li> \refitem cmdendif \endif
<li> \refitem cmdendlatexonly \endlatexonly
<li> \refitem cmdendlink \endlink
<li> \refitem cmdendverbatim \endverbatim
@@ -74,6 +75,7 @@ documentation:
<li> \refitem cmdfile \file
<li> \refitem cmdfn \fn
<li> \refitem cmdhtmlonly \htmlonly
+<li> \refitem cmdif \if
<li> \refitem cmdimage \image
<li> \refitem cmdinclude \include
<li> \refitem cmdingroup \ingroup
@@ -241,10 +243,12 @@ Doxygen. Unrecognized commands are treated as normal text.
in a list. The source code is scanned for documented members and classes.
If any are found, the names are cross-referenced with the documentation.
Source files or directories can be specified using the
- \c EXAMPLE_PATH tag of Doxygen's configuration file.
+ \ref cfg_example_path "EXAMPLE_PATH"
+ tag of Doxygen's configuration file.
If \<file-name\> itself is not unique for the set of example files specified
- by the \c EXAMPLE_PATH tag, you can include part of the absolute path
+ by the
+ \ref cfg_example_path "EXAMPLE_PATH" tag, you can include part of the absolute path
to disambiguate it.
If more that one source file is needed for the example,
@@ -553,6 +557,16 @@ Doxygen. Unrecognized commands are treated as normal text.
a deprecated entity. Can be used to describe alternatives,
expected life span, etc.
+
+<hr>
+\subsection cmdendif \endif
+
+ \addindex \endif
+ Ends a conditional section that was started with \c \if.
+ For each \c \if one and only one matching \c \endif must follow.
+
+ \sa \ref cmdif "\\if"
+
<hr>
\subsection cmdexception \exception <exception-object> { exception description }
@@ -572,6 +586,37 @@ Doxygen. Unrecognized commands are treated as normal text.
the tag \\exceptions is a synonym for this tag.
<hr>
+\subsection cmdif \if <section-label>
+
+ \addindex \if
+ Starts a conditional documentation section. The section ends
+ with a matching \c \endif command. A conditional section is
+ disable by default. To enable it you must put the
+ section-label after the \ref cfg_enabled_sections "ENABLED_SECTIONS"
+ tag in the configuration
+ file. Conditional blocks can be nested. A nested section is
+ only enabled if all enclosing sections are enabled as well.
+
+ \par Example:
+\verbatim
+ /*! Uncoditionally shown documentation.
+ * \if Cond1
+ * Only included if Cond1 is set.
+ * \endif
+ * \if Cond2
+ * Only included if Cond2 is set.
+ * \if Cond3
+ * Only included if Cond2 and Cond3 are set.
+ * \endif
+ * More text.
+ * \endif
+ * Unconditional text.
+ */
+\endverbatim
+
+ \sa section \ref cmdendif "\\endif".
+
+<hr>
\subsection cmdinvariant \invariant { description of invariant }
\addindex \invariant
@@ -832,8 +877,9 @@ Doxygen. Unrecognized commands are treated as normal text.
verbatim including it in the documentation (as the \\include command does).
This is useful if you want to divide the source file into smaller pieces and
add documentation between the pieces.
- Source files or directories can be specified using the \c EXAMPLE_PATH tag
- of Doxygen's configuration file.
+ Source files or directories can be specified using the
+ \ref cfg_example_path "EXAMPLE_PATH"
+ tag of Doxygen's configuration file.
The class and member declarations and definitions inside the code fragment
are `remembered' during the parsing of the comment block that contained
@@ -863,22 +909,26 @@ Doxygen. Unrecognized commands are treated as normal text.
This command can be used to include a source file as a block of code.
The command takes the name of an include file as an argument.
Source files or directories can be specified using the
- \c EXAMPLE_PATH tag of Doxygen's configuration file.
+ \ref cfg_example_path "EXAMPLE_PATH"
+ tag of Doxygen's configuration file.
If \<file-name\> itself is not unique for the set of example files specified
- by the \c EXAMPLE_PATH tag, you can include part of the absolute path
- to disambiguate it.
+ by the
+ \ref cfg_example_path "EXAMPLE_PATH" tag, you can include part
+ of the absolute path to disambiguate it.
Using the \\include command is equivalent to inserting the file into
the documentation block and surrounding it
- with \\code and \\endcode commands.
+ with \ref cmdcode "\\code" and \ref cmdendcode "\\endcode" commands.
The main purpose of the \\include command is to avoid code
duplication in case of example blocks that consist of multiple
source and header files.
For a line by line description of a source files use the
- \\dontinclude command in combination with the \\line, \\skip, \\skipline,
+ \ref cmddontinclude "\\dontinclude" command in combination with
+ the \ref cmdline "\\line", \ref cmdskip "\\skip",
+ \ref cmdskipline "\\skipline",
and \\until commands.
\sa section \ref cmdexample "\\example" and \ref cmddontinclude "\\dontinclude".
diff --git a/doc/config.doc b/doc/config.doc
index 188d14a..da21c74 100644
--- a/doc/config.doc
+++ b/doc/config.doc
@@ -68,6 +68,7 @@ followed by the descriptions of the tags grouped by category.
<li> \refitem cfg_doc_abspath DOC_ABSPATH
<li> \refitem cfg_doc_url DOC_URL
<li> \refitem cfg_enable_preprocessing ENABLE_PREPROCESSING
+<li> \refitem cfg_enabled_sections ENABLED_SECTIONS
<li> \refitem cfg_example_path EXAMPLE_PATH
<li> \refitem cfg_example_patterns EXAMPLE_PATTERNS
<li> \refitem cfg_exclude EXCLUDE
@@ -370,6 +371,13 @@ description.
the \c TAB_SIZE tag can be used to set the number of spaces in a tab.
Doxygen uses this value to replace tabs by spaces in code fragments.
+\anchor cfg_enabled_sections
+<dt>\c ENABLED_SECTIONS <dd>
+ \addindex ENABLED_SECTIONS
+ The \c ENABLE_SECTIONS tag can be used to enable conditional
+ documentation sections, marked by \ref cmdif "\\if" \<section-label\> ...
+ \ref cmdendif "\\endif" blocks.
+
</dl>
\subsection config_input Input related options