Add examples to LaTeX / PDF doxygen manual

Add the examples a shown in the HTML / CHM documentation also to the LaTeX / PDF documentation.

- doc/*.doc
  added latexonly part referencing the example in the appendix

- doc/Doxyfile
  silence the generation of the manual

- doc/doxygen_manual.tex
  add the examples as appendices to the manual, by means of the subinputfrom command the parts included by refman_doc are taken from the specified directory

- examples/*.cfg
  adjusted configuration files ("Doxyfile") to generate LaTeX output

- examples/*.h and examples/*.cpp
  make names unique so no conflicts occur when adding all the examples

- examples/CMakeLists.txt
  add generation of the file to be included (see strip_example.py), adjust dependencies and add the refman_doc.tex as output target

- examples/input_test.cpp
  file added (adjusted copy of example_test.cpp) to overcome name clashes (example_test.cpp would have been included twice)

- examples/strip_example.py
  we are only interested in the documentation files as included in the different examples, so we get those commands. The preamble will be handled by the doxygen_manual.tex and we have already an index in the doxygen_manual.tex so we don't need a separate one from each example.

The module / diagram documentation is dependent on the presence of 'dot', this is reflected in the docblocks.doc, CMakeLists.txt and doxygen_manual.tex

42 files changed, 237 insertions, 143 deletions

diff --git a/examples/CMakeLists.txt b/examples/CMakeLists.txt
index e7b61a1..24bcbfa 100644
--- a/examples/CMakeLists.txt
+++ b/examples/CMakeLists.txt
@@ -53,171 +53,197 @@ add_custom_target(examples
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen class.cfg
-	DEPENDS doxygen class.h class.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/class/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/class/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/class/latex/refman_doc.tex
+	DEPENDS doxygen class.h class.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/class/html/index.html ${PROJECT_BINARY_DIR}/html/examples/class/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen define.cfg
-	DEPENDS doxygen define.h define.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/define/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/define/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/define/latex/refman_doc.tex
+	DEPENDS doxygen define.h define.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/define/html/index.html ${PROJECT_BINARY_DIR}/html/examples/define/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen enum.cfg
-	DEPENDS doxygen enum.h enum.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/enum/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/enum/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/enum/latex/refman_doc.tex
+	DEPENDS doxygen enum.h enum.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/enum/html/index.html ${PROJECT_BINARY_DIR}/html/examples/enum/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen file.cfg
-	DEPENDS doxygen file.h file.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/file/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/file/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/file/latex/refman_doc.tex
+	DEPENDS doxygen file.h file.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/file/html/index.html ${PROJECT_BINARY_DIR}/html/examples/file/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen func.cfg
-	DEPENDS doxygen func.h func.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/func/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/func/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/func/latex/refman_doc.tex
+	DEPENDS doxygen func.h func.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/func/html/index.html ${PROJECT_BINARY_DIR}/html/examples/func/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen page.cfg
-	DEPENDS doxygen page.doc page.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/page/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/page/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/page/latex/refman_doc.tex
+	DEPENDS doxygen page.doc page.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/page/html/index.html ${PROJECT_BINARY_DIR}/html/examples/page/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen relates.cfg
-	DEPENDS doxygen relates.cpp relates.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/relates/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/relates/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/relates/latex/refman_doc.tex
+	DEPENDS doxygen relates.cpp relates.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/relates/html/index.html ${PROJECT_BINARY_DIR}/html/examples/relates/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen author.cfg
-	DEPENDS doxygen author.cpp author.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/author/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/author/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/author/latex/refman_doc.tex
+	DEPENDS doxygen author.cpp author.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/author/html/index.html ${PROJECT_BINARY_DIR}/html/examples/author/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen par.cfg
-	DEPENDS doxygen par.cpp par.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/par/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/par/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/par/latex/refman_doc.tex
+	DEPENDS doxygen par.cpp par.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/par/html/index.html ${PROJECT_BINARY_DIR}/html/examples/par/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen overload.cfg
-	DEPENDS doxygen overload.cpp overload.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/overload/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/overload/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/overload/latex/refman_doc.tex
+	DEPENDS doxygen overload.cpp overload.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/overload/html/index.html ${PROJECT_BINARY_DIR}/html/examples/overload/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen example.cfg
-	DEPENDS doxygen example.cpp example_test.cpp example.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/example/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/example/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/example/latex/refman_doc.tex
+	DEPENDS doxygen example.cpp example_test.cpp example.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/example/html/index.html ${PROJECT_BINARY_DIR}/html/examples/example/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen include.cfg
-	DEPENDS doxygen include.cpp example_test.cpp include.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/include/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/include/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/include/latex/refman_doc.tex
+	DEPENDS doxygen include.cpp include_test.cpp include.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/include/html/index.html ${PROJECT_BINARY_DIR}/html/examples/include/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen qtstyle.cfg
-	DEPENDS doxygen qtstyle.cpp qtstyle.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/qtstyle/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/qtstyle/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/qtstyle/latex/refman_doc.tex
+	DEPENDS doxygen qtstyle.cpp qtstyle.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/qtstyle/html/index.html ${PROJECT_BINARY_DIR}/html/examples/qtstyle/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen jdstyle.cfg
-	DEPENDS doxygen jdstyle.cpp jdstyle.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/jdstyle/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/jdstyle/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/jdstyle/latex/refman_doc.tex
+	DEPENDS doxygen jdstyle.cpp jdstyle.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/jdstyle/html/index.html ${PROJECT_BINARY_DIR}/html/examples/jdstyle/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen structcmd.cfg
-	DEPENDS doxygen structcmd.h structcmd.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/structcmd/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/structcmd/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/structcmd/latex/refman_doc.tex
+	DEPENDS doxygen structcmd.h structcmd.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/structcmd/html/index.html ${PROJECT_BINARY_DIR}/html/examples/structcmd/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen autolink.cfg
-	DEPENDS doxygen autolink.cpp autolink.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/autolink/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/autolink/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/autolink/latex/refman_doc.tex
+	DEPENDS doxygen autolink.cpp autolink.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/autolink/html/index.html ${PROJECT_BINARY_DIR}/html/examples/autolink/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen tag.cfg
-	DEPENDS doxygen tag.cpp tag.cfg ${PROJECT_BINARY_DIR}/html/examples/example/html/index.html
+	DEPENDS doxygen tag.cpp tag.cfg ${PROJECT_BINARY_DIR}/html/examples/example/html/index.html ${TOP}/examples/strip_example.py
 	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/tag/html/index.html
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen restypedef.cfg
-	DEPENDS doxygen restypedef.cpp restypedef.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/restypedef/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/restypedef/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/restypedef/latex/refman_doc.tex
+	DEPENDS doxygen restypedef.cpp restypedef.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/restypedef/html/index.html ${PROJECT_BINARY_DIR}/html/examples/restypedef/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen afterdoc.cfg
-	DEPENDS doxygen afterdoc.h afterdoc.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/afterdoc/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/afterdoc/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/afterdoc/latex/refman_doc.tex
+	DEPENDS doxygen afterdoc.h afterdoc.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/afterdoc/html/index.html ${PROJECT_BINARY_DIR}/html/examples/afterdoc/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen templ.cfg
-	DEPENDS doxygen templ.cpp templ.cfg
+	DEPENDS doxygen templ.cpp templ.cfg ${TOP}/examples/strip_example.py
 	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/template/html/index.html
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen group.cfg
-	DEPENDS doxygen group.cpp group.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/group/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/group/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/group/latex/refman_doc.tex
+	DEPENDS doxygen group.cpp group.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/group/html/index.html ${PROJECT_BINARY_DIR}/html/examples/group/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen memgrp.cfg
-	DEPENDS doxygen memgrp.cpp memgrp.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/memgrp/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/memgrp/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/memgrp/latex/refman_doc.tex
+	DEPENDS doxygen memgrp.cpp memgrp.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/memgrp/html/index.html ${PROJECT_BINARY_DIR}/html/examples/memgrp/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen pyexample.cfg
-	DEPENDS doxygen pyexample.py pyexample.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/pyexample/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/pyexample/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/pyexample/latex/refman_doc.tex
+	DEPENDS doxygen pyexample.py pyexample.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/pyexample/html/index.html ${PROJECT_BINARY_DIR}/html/examples/pyexample/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen tclexample.cfg
-	DEPENDS doxygen tclexample.tcl tclexample.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/tclexample/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/tclexample/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/tclexample/latex/refman_doc.tex
+	DEPENDS doxygen tclexample.tcl tclexample.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/tclexample/html/index.html ${PROJECT_BINARY_DIR}/html/examples/tclexample/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen mux.cfg
-	DEPENDS doxygen mux.vhdl mux.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/mux/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/mux/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/mux/latex/refman_doc.tex
+	DEPENDS doxygen mux.vhdl mux.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/mux/html/index.html ${PROJECT_BINARY_DIR}/html/examples/mux/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen manual.cfg
-	DEPENDS doxygen manual.c manual.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/manual/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/manual/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/manual/latex/refman_doc.tex
+	DEPENDS doxygen manual.c manual.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/manual/html/index.html ${PROJECT_BINARY_DIR}/html/examples/manual/latex/refman_doc.tex
 )
 
 add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen docstring.cfg
-	DEPENDS doxygen docstring.py docstring.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/docstring/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/docstring/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/docstring/latex/refman_doc.tex
+	DEPENDS doxygen docstring.py docstring.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/docstring/html/index.html ${PROJECT_BINARY_DIR}/html/examples/docstring/latex/refman_doc.tex
 )
 
 if (DOT)
   add_custom_command(
 	COMMAND ${EXECUTABLE_OUTPUT_PATH}/doxygen diagrams.cfg
-	DEPENDS doxygen diagrams_a.h diagrams_b.h diagrams_c.h diagrams_d.h diagrams_e.h diagrams.cfg
-	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/diagrams/html/index.html
+        COMMAND ${PYTHON_EXECUTABLE}  ${TOP}/examples/strip_example.py  < ${PROJECT_BINARY_DIR}/html/examples/diagrams/latex/refman.tex > ${PROJECT_BINARY_DIR}/html/examples/diagrams/latex/refman_doc.tex
+	DEPENDS doxygen diagrams_a.h diagrams_b.h diagrams_c.h diagrams_d.h diagrams_e.h diagrams.cfg ${TOP}/examples/strip_example.py
+	OUTPUT ${PROJECT_BINARY_DIR}/html/examples/diagrams/html/index.html ${PROJECT_BINARY_DIR}/html/examples/diagrams/latex/refman_doc.tex
   )
 endif(DOT)
 
diff --git a/examples/afterdoc.cfg b/examples/afterdoc.cfg
index 37bb12d..9ec54fd 100644
--- a/examples/afterdoc.cfg
+++ b/examples/afterdoc.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME      = "AfterDocs"
 OUTPUT_DIRECTORY  = ../html/examples/afterdoc
-GENERATE_LATEX    = NO
+GENERATE_LATEX    = YES
 GENERATE_MAN      = NO
 GENERATE_RTF      = NO
 CASE_SENSE_NAMES  = NO
@@ -8,3 +8,5 @@ INPUT             = afterdoc.h
 QUIET             = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE      = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/afterdoc.h b/examples/afterdoc.h
index 907dabe..b3200a8 100644
--- a/examples/afterdoc.h
+++ b/examples/afterdoc.h
@@ -1,6 +1,6 @@
 /*! A test class */
 
-class Test
+class Afterdoc_Test
 {
   public:
     /** An enum type. 
diff --git a/examples/author.cfg b/examples/author.cfg
index c7b942c..2fafbfe 100644
--- a/examples/author.cfg
+++ b/examples/author.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Author Command"
 OUTPUT_DIRECTORY = ../html/examples/author
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = author.cpp
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/autolink.cfg b/examples/autolink.cfg
index 287b37d..68e5192 100644
--- a/examples/autolink.cfg
+++ b/examples/autolink.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Automatic link generation"
 OUTPUT_DIRECTORY = ../html/examples/autolink
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = autolink.cpp
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/autolink.cpp b/examples/autolink.cpp
index e028f22..71a3c85 100644
--- a/examples/autolink.cpp
+++ b/examples/autolink.cpp
@@ -1,33 +1,33 @@
 /*! \file autolink.cpp
   Testing automatic link generation.
   
-  A link to a member of the Test class: Test::member, 
+  A link to a member of the Autolink_Test class: Autolink_Test::member, 
   
   More specific links to the each of the overloaded members:
-  Test::member(int) and Test#member(int,int)
+  Autolink_Test::member(int) and Autolink_Test#member(int,int)
 
-  A link to a protected member variable of Test: Test#var, 
+  A link to a protected member variable of Autolink_Test: Autolink_Test#var, 
 
   A link to the global enumeration type #GlobEnum.
  
   A link to the define #ABS(x).
   
-  A link to the destructor of the Test class: Test::~Test, 
+  A link to the destructor of the Autolink_Test class: Autolink_Test::~Autolink_Test, 
   
   A link to the typedef ::B.
  
-  A link to the enumeration type Test::EType
+  A link to the enumeration type Autolink_Test::EType
   
-  A link to some enumeration values Test::Val1 and ::GVal2
+  A link to some enumeration values Autolink_Test::Val1 and ::GVal2
 */
 
 /*!
-  Since this documentation block belongs to the class Test no link to 
-  Test is generated.
+  Since this documentation block belongs to the class Autolink_Test no link to 
+  Autolink_Test is generated.
 
-  Two ways to link to a constructor are: #Test and Test().
+  Two ways to link to a constructor are: #Autolink_Test and Autolink_Test().
 
-  Links to the destructor are: #~Test and ~Test().
+  Links to the destructor are: #~Autolink_Test and ~Autolink_Test().
   
   A link to a member in this class: member().
 
@@ -46,19 +46,19 @@
   
   A link to the enumeration type #EType.
 
-  A link to some enumeration values: \link Test::Val1 Val1 \endlink and ::GVal1.
+  A link to some enumeration values: \link Autolink_Test::Val1 Val1 \endlink and ::GVal1.
 
   And last but not least a link to a file: autolink.cpp.
   
   \sa Inside a see also section any word is checked, so EType, 
-      Val1, GVal1, ~Test and member will be replaced by links in HTML.
+      Val1, GVal1, ~Autolink_Test and member will be replaced by links in HTML.
 */
 
-class Test
+class Autolink_Test
 {
   public:
-    Test();               //!< constructor 
-   ~Test();               //!< destructor 
+    Autolink_Test();               //!< constructor 
+   ~Autolink_Test();               //!< destructor 
     void member(int);     /**< A member function. Details. */
     void member(int,int); /**< An overloaded member function. Details */
 
@@ -73,10 +73,10 @@ class Test
 };
 
 /*! details. */
-Test::Test() { }
+Autolink_Test::Autolink_Test() { }
 
 /*! details. */
-Test::~Test() { }
+Autolink_Test::~Autolink_Test() { }
 
 /*! A global variable. */
 int globVar;
@@ -92,8 +92,8 @@ enum GlobEnum {
  */ 
 #define ABS(x) (((x)>0)?(x):-(x))
 
-typedef Test B;
+typedef Autolink_Test B;
 
-/*! \fn typedef Test B
+/*! \fn typedef Autolink_Test B
  *  A type definition. 
  */
diff --git a/examples/class.cfg b/examples/class.cfg
index 579cc75..515689f 100644
--- a/examples/class.cfg
+++ b/examples/class.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Class Command"
 OUTPUT_DIRECTORY = ../html/examples/class
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = class.h
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/dbusxml.cfg b/examples/dbusxml.cfg
index 7b70772..d964ea2 100644
--- a/examples/dbusxml.cfg
+++ b/examples/dbusxml.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME      = "DBusXMLDocs"
 OUTPUT_DIRECTORY  = ../html/examples/dbusxml
-GENERATE_LATEX    = NO
+GENERATE_LATEX    = YES
 GENERATE_MAN      = NO
 GENERATE_RTF      = NO
 CASE_SENSE_NAMES  = NO
@@ -10,3 +10,5 @@ JAVADOC_AUTOBRIEF = YES
 EXTRACT_ALL       = YES
 SEARCHENGINE      = NO
 EXTENSION_MAPPING = xml=dbusxml
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/define.cfg b/examples/define.cfg
index 8a12da8..491c1eb 100644
--- a/examples/define.cfg
+++ b/examples/define.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Define Command"
 OUTPUT_DIRECTORY = ../html/examples/define
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -9,3 +9,5 @@ ENABLE_PREPROCESSING = YES
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/diagrams.cfg b/examples/diagrams.cfg
index 5301786..19cbbc8 100644
--- a/examples/diagrams.cfg
+++ b/examples/diagrams.cfg
@@ -2,7 +2,7 @@ PROJECT_NAME       = "Diagrams"
 OUTPUT_DIRECTORY   = ../html/examples/diagrams
 HAVE_DOT           = YES
 EXTRACT_ALL        = YES
-GENERATE_LATEX     = NO
+GENERATE_LATEX     = YES
 GENERATE_MAN       = NO
 GENERATE_RTF       = NO
 CASE_SENSE_NAMES = NO
@@ -12,3 +12,5 @@ FILE_PATTERNS      = diagrams_*.h
 QUIET              = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/docstring.cfg b/examples/docstring.cfg
index bd65500..60b089e 100644
--- a/examples/docstring.cfg
+++ b/examples/docstring.cfg
@@ -1,7 +1,7 @@
 PROJECT_NAME     = "Python"
 OUTPUT_DIRECTORY = ../html/examples/docstring
 EXTRACT_ALL      = YES
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 OPTIMIZE_OUTPUT_JAVA = YES
@@ -9,3 +9,5 @@ INPUT            = docstring.py
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/enum.cfg b/examples/enum.cfg
index 7732be8..74bb651 100644
--- a/examples/enum.cfg
+++ b/examples/enum.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Enum Command"
 OUTPUT_DIRECTORY = ../html/examples/enum
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = enum.h
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/enum.h b/examples/enum.h
index 4c54fab..ab7ffa6 100644
--- a/examples/enum.h
+++ b/examples/enum.h
@@ -1,4 +1,4 @@
-class Test
+class Enum_Test
 {
   public:
     enum TEnum { Val1, Val2 };
@@ -11,14 +11,14 @@ class Test
     };
 };
 
-/*! \class Test
+/*! \class Enum_Test
  * The class description.
  */
 
-/*! \enum Test::TEnum
+/*! \enum Enum_Test::TEnum
  * A description of the enum type.
  */
 
-/*! \var Test::TEnum Test::Val1
+/*! \var Enum_Test::TEnum Enum_Test::Val1
  * The description of the first enum value.
  */
diff --git a/examples/example.cfg b/examples/example.cfg
index f57e4ba..c55c6b9 100644
--- a/examples/example.cfg
+++ b/examples/example.cfg
@@ -1,7 +1,7 @@
 PROJECT_NAME      = "Example Command"
 OUTPUT_DIRECTORY  = ../html/examples/example
 #GENERATE_TAGFILE  = example.tag
-GENERATE_LATEX    = NO
+GENERATE_LATEX    = YES
 GENERATE_MAN      = NO
 GENERATE_RTF      = NO
 CASE_SENSE_NAMES  = NO
@@ -10,3 +10,5 @@ EXAMPLE_PATH      = example_test.cpp
 QUIET             = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE      = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/example.cpp b/examples/example.cpp
index 230d6ec..657c266 100644
--- a/examples/example.cpp
+++ b/examples/example.cpp
@@ -1,8 +1,8 @@
-/** A Test class.
+/** A Example_Test class.
  *  More details about this class.
  */
 
-class Test
+class Example_Test
 {
   public:
     /** An example member function.
@@ -11,9 +11,9 @@ class Test
     void example();
 };
 
-void Test::example() {}
+void Example_Test::example() {}
 
 /** \example example_test.cpp
- * This is an example of how to use the Test class.
+ * This is an example of how to use the Example_Test class.
  * More details about this example.
  */
diff --git a/examples/example_test.cpp b/examples/example_test.cpp
index a7e1643..cefee43 100644
--- a/examples/example_test.cpp
+++ b/examples/example_test.cpp
@@ -1,5 +1,5 @@
 void main()
 {
-  Test t;
+  Example_Test t;
   t.example();
 }
diff --git a/examples/file.cfg b/examples/file.cfg
index e622c1e..6b20b87 100644
--- a/examples/file.cfg
+++ b/examples/file.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "File Command"
 OUTPUT_DIRECTORY = ../html/examples/file
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = file.h
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/func.cfg b/examples/func.cfg
index 4929f66..c0feb0f 100644
--- a/examples/func.cfg
+++ b/examples/func.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Fn Command"
 OUTPUT_DIRECTORY = ../html/examples/func
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = func.h
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/func.h b/examples/func.h
index b335448..cc0ac38 100644
--- a/examples/func.h
+++ b/examples/func.h
@@ -1,18 +1,18 @@
-class Test
+class Fn_Test
 {
   public:
     const char *member(char,int) throw(std::out_of_range);
 };
 
-const char *Test::member(char c,int n) throw(std::out_of_range) {}
+const char *Fn_Test::member(char c,int n) throw(std::out_of_range) {}
 
-/*! \class Test
- * \brief Test class.
+/*! \class Fn_Test
+ * \brief Fn_Test class.
  *
- * Details about Test.
+ * Details about Fn_Test.
  */
 
-/*! \fn const char *Test::member(char c,int n) 
+/*! \fn const char *Fn_Test::member(char c,int n) 
  *  \brief A member function.
  *  \param c a character.
  *  \param n an integer.
diff --git a/examples/group.cfg b/examples/group.cfg
index 7882713..83911b8 100644
--- a/examples/group.cfg
+++ b/examples/group.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Grouping"
 OUTPUT_DIRECTORY = ../html/examples/group
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = group.cpp
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/include.cfg b/examples/include.cfg
index 4ecdf8f..abaecc6 100644
--- a/examples/include.cfg
+++ b/examples/include.cfg
@@ -1,11 +1,13 @@
 PROJECT_NAME     = "Include Command"
 OUTPUT_DIRECTORY = ../html/examples/include
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
 INPUT            = include.cpp
-EXAMPLE_PATH     = example_test.cpp
+EXAMPLE_PATH     = include_test.cpp
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/include.cpp b/examples/include.cpp
index 674ad13..ba8c054 100644
--- a/examples/include.cpp
+++ b/examples/include.cpp
@@ -1,7 +1,7 @@
 
 /*! A test class. */
 
-class Test
+class Include_Test
 {
   public:
     /// a member function
@@ -9,12 +9,12 @@ class Test
 };
 
 /*! \page example
- *  \dontinclude example_test.cpp
+ *  \dontinclude include_test.cpp
  *  Our main function starts like this:
  *  \skip main
  *  \until {
- *  First we create an object \c t of the Test class.
- *  \skipline Test
+ *  First we create an object \c t of the Include_Test class.
+ *  \skipline Include_Test
  *  Then we call the example member function 
  *  \line example
  *  After that our little test routine ends.
diff --git a/examples/include_test.cpp b/examples/include_test.cpp
new file mode 100644
index 0000000..df8634a
--- /dev/null
+++ b/examples/include_test.cpp
@@ -0,0 +1,5 @@
+void main()
+{
+  Include_Test t;
+  t.example();
+}
diff --git a/examples/jdstyle.cfg b/examples/jdstyle.cfg
index 15eccee..0ddc0d9 100644
--- a/examples/jdstyle.cfg
+++ b/examples/jdstyle.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME      = "JavaDoc Style"
 OUTPUT_DIRECTORY  = ../html/examples/jdstyle
-GENERATE_LATEX    = NO
+GENERATE_LATEX    = YES
 GENERATE_MAN      = NO
 GENERATE_RTF      = NO
 CASE_SENSE_NAMES  = NO
@@ -8,3 +8,5 @@ INPUT             = jdstyle.cpp
 QUIET             = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE      = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/jdstyle.cpp b/examples/jdstyle.cpp
index bd8b9a7..04885e4 100644
--- a/examples/jdstyle.cpp
+++ b/examples/jdstyle.cpp
@@ -2,7 +2,7 @@
  *  A test class. A more elaborate class description.
  */
 
-class Test
+class Javadoc_Test
 {
   public:
 
@@ -23,20 +23,20 @@ class Test
        * A constructor.
        * A more elaborate description of the constructor.
        */
-      Test();
+      Javadoc_Test();
 
       /**
        * A destructor.
        * A more elaborate description of the destructor.
        */
-     ~Test();
+     ~Javadoc_Test();
     
       /**
        * a normal member taking two arguments and returning an integer value.
        * @param a an integer argument.
        * @param s a constant character pointer.
-       * @see Test()
-       * @see ~Test()
+       * @see Javadoc_Test()
+       * @see ~Javadoc_Test()
        * @see testMeToo()
        * @see publicVar()
        * @return The test results
diff --git a/examples/manual.cfg b/examples/manual.cfg
index 75d1fc5..07040d9 100644
--- a/examples/manual.cfg
+++ b/examples/manual.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME           = "Manual inheritance and membership"
 OUTPUT_DIRECTORY       = ../html/examples/manual
-GENERATE_LATEX         = NO
+GENERATE_LATEX         = YES
 GENERATE_MAN           = NO
 GENERATE_RTF           = NO
 CASE_SENSE_NAMES       = NO
@@ -14,3 +14,5 @@ INLINE_SOURCES         = YES
 REFERENCED_BY_RELATION = YES
 REFERENCES_RELATION    = YES
 SEARCHENGINE           = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/memgrp.cfg b/examples/memgrp.cfg
index dea742c..d609778 100644
--- a/examples/memgrp.cfg
+++ b/examples/memgrp.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME         = "Member Grouping"
 OUTPUT_DIRECTORY     = ../html/examples/memgrp
-GENERATE_LATEX       = NO
+GENERATE_LATEX       = YES
 GENERATE_MAN         = NO
 GENERATE_RTF         = NO
 CASE_SENSE_NAMES     = NO
@@ -9,3 +9,5 @@ QUIET                = YES
 DISTRIBUTE_GROUP_DOC = YES
 JAVADOC_AUTOBRIEF    = YES
 SEARCHENGINE         = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/memgrp.cpp b/examples/memgrp.cpp
index 77f03a4..9a24774 100644
--- a/examples/memgrp.cpp
+++ b/examples/memgrp.cpp
@@ -1,5 +1,5 @@
 /** A class. Details */
-class Test
+class Memgrp_Test
 {
   public:
     //@{
@@ -15,17 +15,17 @@ class Test
     void func2InGroup2();
 };
 
-void Test::func1InGroup1() {}
-void Test::func2InGroup1() {}
+void Memgrp_Test::func1InGroup1() {}
+void Memgrp_Test::func2InGroup1() {}
 
 /** @name Group2
  *  Description of group 2. 
  */
 ///@{
 /** Function 2 in group 2. Details. */
-void Test::func2InGroup2() {}
+void Memgrp_Test::func2InGroup2() {}
 /** Function 1 in group 2. Details. */
-void Test::func1InGroup2() {}
+void Memgrp_Test::func1InGroup2() {}
 ///@}
 
 /*! \file 
diff --git a/examples/mux.cfg b/examples/mux.cfg
index 11aa7ca..861f2f6 100644
--- a/examples/mux.cfg
+++ b/examples/mux.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME         = Mux
 OUTPUT_DIRECTORY     = ../html/examples/mux
-GENERATE_LATEX       = NO
+GENERATE_LATEX       = YES
 GENERATE_MAN         = NO
 GENERATE_RTF         = NO
 CASE_SENSE_NAMES     = NO
@@ -14,3 +14,5 @@ INHERIT_DOCS         = NO
 SEARCHENGINE         = NO
 ENABLE_PREPROCESSING = NO
 EXTRACT_PACKAGE      = YES
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/overload.cfg b/examples/overload.cfg
index 9677065..71ebcc5 100644
--- a/examples/overload.cfg
+++ b/examples/overload.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Overloaded Command"
 OUTPUT_DIRECTORY = ../html/examples/overload
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -9,3 +9,5 @@ INPUT            = overload.cpp
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/overload.cpp b/examples/overload.cpp
index 02bcced..7aeb1cb 100644
--- a/examples/overload.cpp
+++ b/examples/overload.cpp
@@ -1,25 +1,25 @@
-class Test 
+class Overload_Test 
 {
   public:
     void drawRect(int,int,int,int);
     void drawRect(const Rect &r);
 };
 
-void Test::drawRect(int x,int y,int w,int h) {}
-void Test::drawRect(const Rect &r) {}
+void Overload_Test::drawRect(int x,int y,int w,int h) {}
+void Overload_Test::drawRect(const Rect &r) {}
 
-/*! \class Test
+/*! \class Overload_Test
  *  \brief A short description.
  *   
  *  More text.
  */
 
-/*! \fn void Test::drawRect(int x,int y,int w,int h)
+/*! \fn void Overload_Test::drawRect(int x,int y,int w,int h)
  * This command draws a rectangle with a left upper corner at ( \a x , \a y ),
  * width \a w and height \a h. 
  */
 
 /*!
- * \overload void Test::drawRect(const Rect &r)
+ * \overload void Overload_Test::drawRect(const Rect &r)
  */
 
diff --git a/examples/page.cfg b/examples/page.cfg
index 980cb17..972368a 100644
--- a/examples/page.cfg
+++ b/examples/page.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Page Command"
 OUTPUT_DIRECTORY = ../html/examples/page
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = page.doc
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/par.cfg b/examples/par.cfg
index 5be0e03..fe4be84 100644
--- a/examples/par.cfg
+++ b/examples/par.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Par Command"
 OUTPUT_DIRECTORY = ../html/examples/par
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = par.cpp
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/par.cpp b/examples/par.cpp
index 6fd2c4e..cae55d7 100644
--- a/examples/par.cpp
+++ b/examples/par.cpp
@@ -1,4 +1,4 @@
-/*! \class Test
+/*! \class Par_Test
  * Normal text.
  *
  * \par User defined paragraph:
@@ -17,4 +17,4 @@
  * More normal text. 
  */
   
-class Test {};
+class Par_Test {};
diff --git a/examples/pyexample.cfg b/examples/pyexample.cfg
index 9b44984..4569425 100644
--- a/examples/pyexample.cfg
+++ b/examples/pyexample.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Python"
 OUTPUT_DIRECTORY = ../html/examples/pyexample
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 OPTIMIZE_OUTPUT_JAVA = YES
@@ -8,3 +8,5 @@ INPUT            = pyexample.py
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/qtstyle.cfg b/examples/qtstyle.cfg
index beae9e4..1516c7e 100644
--- a/examples/qtstyle.cfg
+++ b/examples/qtstyle.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Qt Style"
 OUTPUT_DIRECTORY = ../html/examples/qtstyle
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = qtstyle.cpp
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/qtstyle.cpp b/examples/qtstyle.cpp
index e24d541..8b55c8d 100644
--- a/examples/qtstyle.cpp
+++ b/examples/qtstyle.cpp
@@ -3,7 +3,7 @@
   A more elaborate class description.
 */
 
-class Test
+class QTstyle_Test
 {
   public:
 
@@ -25,20 +25,20 @@ class Test
     /*!
       A more elaborate description of the constructor.
     */
-    Test();
+    QTstyle_Test();
 
     //! A destructor.
     /*!
       A more elaborate description of the destructor.
     */
-   ~Test();
+   ~QTstyle_Test();
     
     //! A normal member taking two arguments and returning an integer value.
     /*!
       \param a an integer argument.
       \param s a constant character pointer.
       \return The test results
-      \sa Test(), ~Test(), testMeToo() and publicVar()
+      \sa QTstyle_Test(), ~QTstyle_Test(), testMeToo() and publicVar()
     */
     int testMe(int a,const char *s);
        
diff --git a/examples/relates.cfg b/examples/relates.cfg
index 9155a7e..89f46da 100644
--- a/examples/relates.cfg
+++ b/examples/relates.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Relates Command"
 OUTPUT_DIRECTORY = ../html/examples/relates
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = relates.cpp
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/restypedef.cfg b/examples/restypedef.cfg
index 6282a64..63d2ea5 100644
--- a/examples/restypedef.cfg
+++ b/examples/restypedef.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Resolving Typedefs"
 OUTPUT_DIRECTORY = ../html/examples/restypedef
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = restypedef.cpp
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/strip_example.py b/examples/strip_example.py
new file mode 100644
index 0000000..d88b893
--- /dev/null
+++ b/examples/strip_example.py
@@ -0,0 +1,9 @@
+import sys
+do_print = False
+for line in sys.stdin:
+    if line.startswith("%--- Begin generated contents ---"):
+       do_print = True
+    elif line.startswith("%--- End generated contents ---"):
+       do_print = False
+    elif do_print:
+       sys.stdout.write(line)
diff --git a/examples/structcmd.cfg b/examples/structcmd.cfg
index d60cfcf..d510d27 100644
--- a/examples/structcmd.cfg
+++ b/examples/structcmd.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME     = "Structural commands"
 OUTPUT_DIRECTORY = ../html/examples/structcmd
-GENERATE_LATEX   = NO
+GENERATE_LATEX   = YES
 GENERATE_MAN     = NO
 GENERATE_RTF     = NO
 CASE_SENSE_NAMES = NO
@@ -8,3 +8,5 @@ INPUT            = structcmd.h
 QUIET            = YES
 JAVADOC_AUTOBRIEF = YES
 SEARCHENGINE     = NO
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES
diff --git a/examples/tclexample.cfg b/examples/tclexample.cfg
index e51f4fc..e151d14 100644
--- a/examples/tclexample.cfg
+++ b/examples/tclexample.cfg
@@ -1,6 +1,6 @@
 PROJECT_NAME       = "Tcl"
 OUTPUT_DIRECTORY   = ../html/examples/tclexample
-GENERATE_LATEX     = NO
+GENERATE_LATEX     = YES
 GENERATE_MAN       = NO
 GENERATE_RTF       = NO
 CASE_SENSE_NAMES   = NO
@@ -10,3 +10,5 @@ JAVADOC_AUTOBRIEF  = YES
 SEARCHENGINE       = NO
 INLINE_SOURCES     = YES
 HIDE_UNDOC_MEMBERS = YES
+COMPACT_LATEX = YES
+LATEX_HIDE_INDICES     = YES