diff options
author | albert-github <albert.tests@gmail.com> | 2015-09-06 09:24:48 (GMT) |
---|---|---|
committer | albert-github <albert.tests@gmail.com> | 2015-09-06 09:24:48 (GMT) |
commit | 3a236fd01dc23d2d979e06d848f61b002cb4e6ee (patch) | |
tree | 0f5e74f06aa6692003802c84911694cec3be6caa /doc | |
parent | 5e11f885eea694c2ecfeae6ff5774b66eea312e4 (diff) | |
download | Doxygen-3a236fd01dc23d2d979e06d848f61b002cb4e6ee.zip Doxygen-3a236fd01dc23d2d979e06d848f61b002cb4e6ee.tar.gz Doxygen-3a236fd01dc23d2d979e06d848f61b002cb4e6ee.tar.bz2 |
Add examples to LaTeX / PDF doxygen manual
- doc/*.doc
use include instead of verbinclude to make use of the code coloring in the examples
- examples/*.cfg
some examples automatically display the code from the include file (*.h), for the examples it is better to show the comment as well.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/autolink.doc | 4 | ||||
-rw-r--r-- | doc/commands.doc | 28 | ||||
-rw-r--r-- | doc/diagrams.doc | 10 | ||||
-rw-r--r-- | doc/grouping.doc | 4 |
4 files changed, 23 insertions, 23 deletions
diff --git a/doc/autolink.doc b/doc/autolink.doc index fe0bdea..b0020b1 100644 --- a/doc/autolink.doc +++ b/doc/autolink.doc @@ -110,7 +110,7 @@ patterns 3 and 7 in this case. \par Example: - \verbinclude autolink.cpp + \include autolink.cpp \htmlonly Click <a href="examples/autolink/html/index.html">here</a> for the corresponding HTML documentation that is generated by Doxygen. @@ -130,7 +130,7 @@ typedef struct StructName TypeName when either StructName itself or TypeName is encountered. \par Example: - \verbinclude restypedef.cpp + \include restypedef.cpp \htmlonly Click <a href="examples/restypedef/html/restypedef_8cpp.html">here</a> for the corresponding HTML documentation that is generated by Doxygen. diff --git a/doc/commands.doc b/doc/commands.doc index 01d069f..df120a2 100644 --- a/doc/commands.doc +++ b/doc/commands.doc @@ -358,7 +358,7 @@ Structural indicators the \ref cmdheaderfile "\\headerfile" command. \par Example: - \verbinclude class.h + \include class.h \htmlonly Click <a href="examples/class/html/index.html">here</a> for the corresponding HTML documentation that is generated by doxygen. @@ -376,7 +376,7 @@ Structural indicators \c \#define macro. \par Example: - \verbinclude define.h + \include define.h \htmlonly Click <a href="examples/define/html/define_8h.html">here</a> for the corresponding HTML documentation that is generated by doxygen. @@ -429,7 +429,7 @@ Structural indicators of an anonymous enum can. \par Example: - \verbinclude enum.h + \include enum.h \htmlonly Click <a href="examples/enum/html/class_test.html">here</a> for the corresponding HTML documentation that is generated by doxygen. @@ -462,9 +462,9 @@ Structural indicators the \ref cmdinclude "\\include" command can be used. \par Example: - \verbinclude example.cpp + \include example.cpp Where the example file \c example_test.cpp looks as follows: - \verbinclude example_test.cpp + \include example_test.cpp \htmlonly Click <a href="examples/example/html/examples.html">here</a> for the corresponding HTML documentation that is generated by doxygen. @@ -522,7 +522,7 @@ Structural indicators only be included in the output if the file they are in is documented as well. \par Example: - \verbinclude file.h + \include file.h \htmlonly Click <a href="examples/file/html/file_8h.html">here</a> for the corresponding HTML documentation that is generated by doxygen. @@ -560,7 +560,7 @@ Structural indicators information and thus to errors. \par Example: - \verbinclude func.h + \include func.h \htmlonly Click <a href="examples/func/html/class_test.html">here</a> for the corresponding HTML documentation that is generated by doxygen. @@ -817,7 +817,7 @@ Structural indicators \par Note 2: The \c \\overload command does not work inside a one-line comment. \par Example: - \verbinclude examples/overload.cpp + \include overload.cpp \htmlonly Click <a href="examples/overload/html/class_test.html">here</a> for the corresponding HTML documentation that is generated by doxygen. @@ -845,7 +845,7 @@ Structural indicators starts a new section in the chapter 'Page documentation'. \par Example: - \verbinclude page.doc + \include page.doc \htmlonly Click <a href="examples/page/html/pages.html">here</a> for the corresponding HTML documentation that is generated by doxygen. @@ -1005,7 +1005,7 @@ Structural indicators only works for functions. \par Example: - \verbinclude relates.cpp + \include relates.cpp \htmlonly Click <a href="examples/relates/html/class_string.html">here</a> for the corresponding HTML documentation that is generated by doxygen. @@ -1160,7 +1160,7 @@ Section indicators sectioning command is encountered. \par Example: - \verbinclude author.cpp + \include author.cpp \htmlonly Click <a href="examples/author/html/class_some_nice_class.html">here</a> for the corresponding HTML documentation that is generated by doxygen. @@ -1507,7 +1507,7 @@ ALIASES = "english=\if english" \ sectioning command is encountered. \par Example: - \verbinclude par.cpp + \include par.cpp \htmlonly Click <a href="examples/par/html/class_test.html">here</a> for the corresponding HTML documentation that is generated by doxygen. @@ -2115,9 +2115,9 @@ Commands for displaying examples \c \\dontinclude command sets the pointer to the first line of the example. \par Example: - \verbinclude include.cpp + \include include.cpp Where the example file \c example_test.cpp looks as follows: - \verbinclude example_test.cpp + \include example_test.cpp \htmlonly Click <a href="examples/include/html/example.html">here</a> for the corresponding HTML documentation that is generated by doxygen. diff --git a/doc/diagrams.doc b/doc/diagrams.doc index 7d497bd..2660b8e 100644 --- a/doc/diagrams.doc +++ b/doc/diagrams.doc @@ -127,15 +127,15 @@ Here are a couple of header files that together show the various diagrams that doxygen can generate: <code>diagrams_a.h</code> -\verbinclude diagrams_a.h +\include diagrams_a.h <code>diagrams_b.h</code> -\verbinclude diagrams_b.h +\include diagrams_b.h <code>diagrams_c.h</code> -\verbinclude diagrams_c.h +\include diagrams_c.h <code>diagrams_d.h</code> -\verbinclude diagrams_d.h +\include diagrams_d.h <code>diagrams_e.h</code> -\verbinclude diagrams_e.h +\include diagrams_e.h \htmlonly Click <a href="examples/diagrams/html/index.html">here</a> diff --git a/doc/grouping.doc b/doc/grouping.doc index f369998..4357d27 100644 --- a/doc/grouping.doc +++ b/doc/grouping.doc @@ -135,7 +135,7 @@ files to define the hierarchy and \ref cmdweakgroup "\\weakgroup" in .c files without having to duplicate the hierarchy exactly. \par Example: -\verbinclude group.cpp +\include group.cpp \htmlonly Click <a href="examples/group/html/modules.html">here</a> @@ -192,7 +192,7 @@ you should put a \ref cmdnosubgrouping "\\nosubgrouping" command inside the documentation of the class. \par Example: -\verbinclude memgrp.cpp +\include memgrp.cpp \htmlonly Click <a href="examples/memgrp/html/class_test.html">here</a> |