summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authoralbert-github <albert.tests@gmail.com>2016-08-21 12:17:20 (GMT)
committeralbert-github <albert.tests@gmail.com>2016-08-21 12:17:20 (GMT)
commitba848363081c44c9aa9e91b193054983f562e90c (patch)
tree246ba9ad0b053e7f99815c906600d99deb690378 /doc
parentb24d9db1ae409195c18e83f1d31c2a135964f141 (diff)
downloadDoxygen-ba848363081c44c9aa9e91b193054983f562e90c.zip
Doxygen-ba848363081c44c9aa9e91b193054983f562e90c.tar.gz
Doxygen-ba848363081c44c9aa9e91b193054983f562e90c.tar.bz2
Introducing commands includedoc and snippetdoc
Purpose to have the possibility to have repeating texts not repeated in the comments. The commands include and snippet introduce code blocks whilst the commands includedoc and snippetdoc inclode the text as is and it will be parsed by doxygen.
Diffstat (limited to 'doc')
-rw-r--r--doc/commands.doc44
1 files changed, 40 insertions, 4 deletions
diff --git a/doc/commands.doc b/doc/commands.doc
index dbc7504..d9d38e8 100644
--- a/doc/commands.doc
+++ b/doc/commands.doc
@@ -115,6 +115,7 @@ documentation:
\refitem cmdimage \\image
\refitem cmdimplements \\implements
\refitem cmdinclude \\include
+\refitem cmdincludedoc \\includedoc
\refitem cmdincludelineno \\includelineno
\refitem cmdingroup \\ingroup
\refitem cmdinternal \\internal
@@ -177,6 +178,7 @@ documentation:
\refitem cmdskip \\skip
\refitem cmdskipline \\skipline
\refitem cmdsnippet \\snippet
+\refitem cmdsnippetdoc \\snippetdoc
\refitem cmdstartuml \\startuml
\refitem cmdstruct \\struct
\refitem cmdsubpage \\subpage
@@ -2171,8 +2173,8 @@ Commands for displaying examples
\note Doxygen's special commands do not work inside blocks of code.
It is allowed to nest C-style comments inside a code block though.
- \sa sections \ref cmdexample "\\example", \ref cmddontinclude "\\dontinclude", and
- \ref cmdverbatim "\\verbatim".
+ \sa sections \ref cmdexample "\\example", \ref cmddontinclude "\\dontinclude",
+ \ref cmdverbatim "\\verbatim" and \ref cmdincludedoc "\\includedoc".
<hr>
\section cmdincludelineno \\includelineno <file-name>
@@ -2184,6 +2186,22 @@ Commands for displaying examples
\sa section \ref cmdinclude "\\include".
<hr>
+\section cmdincludedoc \\includedoc <file-name>
+
+ \addindex \\includedoc
+ This command works the same way as \ref cmdinclude "\\include", but it will include
+ the content of the file as if it were at the place where this command is called.
+ The result is that the content is parsed by doxygen and placed in the documentation.
+
+ \note Some commands like \ref cmdcond "\\cond" and \ref cmdif "\\if" don't work with
+ this command due to the moment of parsing.
+
+ \note The included documentation should not have comment signs in it as the will appear
+ in the documentation as well.
+
+ \sa section \ref cmdinclude "\\include".
+
+<hr>
\section cmdline \\line ( pattern )
\addindex \\line
@@ -2285,6 +2303,23 @@ Commands for displaying examples
see section \ref cmddontinclude "\\dontinclude" for an alternative way
to include fragments of a source file that does not require markers.
+ \sa section \ref cmdsnippetdoc "\\snippetdoc".
+<hr>
+\section cmdsnippetdoc \\snippetdoc <file-name> ( block_id )
+
+ \addindex \\snippetdoc
+ This command works the same way as \ref cmdsnippet "\\snippet", but it will include
+ the content of the file between the `block-id`s as if it were at the place where this command is called.
+ The result is that the content is parsed by doxygen and placed in the documentation.
+
+ \note Some commands like \ref cmdcond "\\cond" and \ref cmdif "\\if" don't work with
+ this command due to the moment of parsing.
+
+ \note The included documentation should not have comment signs in it as the will appear
+ in the documentation as well.
+
+ \sa section \ref cmdsnippet "\\snippet" and \ref cmdincludedoc "\\includedoc".
+
<hr>
\section cmduntil \\until ( pattern )
@@ -3177,8 +3212,9 @@ class Receiver
\c \\verbatim command or the parser will get confused!
\sa sections \ref cmdcode "\\code",
- \ref cmdendverbatim "\\endverbatim", and
- \ref cmdverbinclude "\\verbinclude".
+ \ref cmdendverbatim "\\endverbatim",
+ \ref cmdverbinclude "\\verbinclude", and
+ \ref cmdverbincludedooc "\\verbincludedooc".
<hr>
\section cmdxmlonly \\xmlonly