summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authoralbert-github <albert.tests@gmail.com>2019-05-23 10:40:49 (GMT)
committeralbert-github <albert.tests@gmail.com>2019-05-23 10:40:49 (GMT)
commit0ed88e25a69af7aec1acf0b610783f9d02f7739a (patch)
tree276e17e180b3a90ad1e4b070f71d339fc5e5ceef /doc
parent5c9d812083af06c9e683c9ff2e32f5839066863c (diff)
downloadDoxygen-0ed88e25a69af7aec1acf0b610783f9d02f7739a.zip
Doxygen-0ed88e25a69af7aec1acf0b610783f9d02f7739a.tar.gz
Doxygen-0ed88e25a69af7aec1acf0b610783f9d02f7739a.tar.bz2
More than 26 appendices in LaTeX manual
The 1.8.15 manual had 26 examples but due to the fact that a new example was created we got 27 and thus the characters A-Z are not sufficient. In a number of LaTeX versions this leads to messages like: ``` Appendix \GenericError { }{LaTeX Error: Counter too large}{See th e LaTeX manual or LaTeX Companion for explanation.}{You've lost some text. Try typing <return> to proceed.\MessageBreak If that doesn't work, type X <retu rn> to quit.}. ! LaTeX Error: Counter too large. ``` Solution for this is to reorganize the examples a little bit. This is done here by means of the "groups": - Style examples - Language Examples as a consequence also the sections / subsections etc had to go 1 level deeper and this is accomplished by defining a new environment in which the different sections go 1 level deeper.
Diffstat (limited to 'doc')
-rw-r--r--doc/doxygen_manual.tex60
1 files changed, 44 insertions, 16 deletions
diff --git a/doc/doxygen_manual.tex b/doc/doxygen_manual.tex
index 5265b9b..bf269d2 100644
--- a/doc/doxygen_manual.tex
+++ b/doc/doxygen_manual.tex
@@ -57,6 +57,16 @@
\usepackage{amssymb}
\usepackage{doxygen}
\usepackage{manual}
+%%
+\makeatletter
+\newenvironment{DoxygenSubAppendix}{%
+ \renewcommand{\doxysection}{\@ifstar{\doxysubsection@star}{\doxysubsection@nostar}}%
+ \renewcommand{\doxysubsection}{\@ifstar{\doxysubsubsection@star}{\doxysubsubsection@nostar}}
+ \renewcommand{\doxysubsubsection}{\@ifstar{\doxyparagraph@star}{\doxyparagraph@nostar}}
+ \renewcommand{\doxyparagraph}{\@ifstar{\doxysubparagraph@star}{\doxysubparagraph@nostar}}
+}{}
+\makeatother
+%%
\newcommand{\+}{\discretionary{\mbox{\scriptsize$\hookleftarrow$}}{}{}}
\lstset{language=C++,inputencoding=utf8,basicstyle=\footnotesize,breaklines=true,breakatwhitespace=true,tabsize=8,numbers=left }
\makeindex
@@ -147,22 +157,42 @@ Written by Dimitri van Heesch\\[2ex]
\subinputfrom{../html/examples/group/latex/}{refman_doc}
\chapter{Member Groups Example}\label{memgrp_example}\hypertarget{memgrp_example}{}
\subinputfrom{../html/examples/memgrp/latex/}{refman_doc}
-\chapter{After Block Example}\label{afterdoc_example}\hypertarget{afterdoc_example}{}
-\subinputfrom{../html/examples/afterdoc/latex/}{refman_doc}
-\chapter{QT Style Example}\label{qtstyle_example}\hypertarget{qtstyle_example}{}
-\subinputfrom{../html/examples/qtstyle/latex/}{refman_doc}
-\chapter{Javadoc Style Example}\label{jdstyle_example}\hypertarget{jdstyle_example}{}
-\subinputfrom{../html/examples/jdstyle/latex/}{refman_doc}
+\chapter{Style Examples}
+ \doxysection{After Block Example}\label{afterdoc_example}\hypertarget{afterdoc_example}{}
+ \begin{DoxygenSubAppendix}
+ \subinputfrom{../html/examples/afterdoc/latex/}{refman_doc}
+ \end{DoxygenSubAppendix}
+ \doxysection{QT Style Example}\label{qtstyle_example}\hypertarget{qtstyle_example}{}
+ \begin{DoxygenSubAppendix}
+ \subinputfrom{../html/examples/qtstyle/latex/}{refman_doc}
+ \end{DoxygenSubAppendix}
+ \doxysection{Javadoc Style Example}\label{jdstyle_example}\hypertarget{jdstyle_example}{}
+ \begin{DoxygenSubAppendix}
+ \subinputfrom{../html/examples/jdstyle/latex/}{refman_doc}
+ \end{DoxygenSubAppendix}
+ \doxysection{Javadoc Banner Example}\label{javadoc_banner_example}\hypertarget{javadoc_banner_example}{}
+ \begin{DoxygenSubAppendix}
+ \subinputfrom{../html/examples/javadoc-banner/latex/}{refman_doc}
+ \end{DoxygenSubAppendix}
\chapter{Structural Commands Example}\label{structcmd_example}\hypertarget{structcmd_example}{}
\subinputfrom{../html/examples/structcmd/latex/}{refman_doc}
-\chapter{Python Docstring Example}\label{python_example}\hypertarget{python_example}{}
-\subinputfrom{../html/examples/docstring/latex/}{refman_doc}
-\chapter{Python Example}\label{py_example}\hypertarget{py_example}{}
-\subinputfrom{../html/examples/pyexample/latex/}{refman_doc}
-\chapter{VHDL Example}\label{vhdl_example}\hypertarget{vhdl_example}{}
-\subinputfrom{../html/examples/mux/latex/}{refman_doc}
-\chapter{Tcl Example}\label{tcl_example}\hypertarget{tcl_example}{}
-\subinputfrom{../html/examples/tclexample/latex/}{refman_doc}
+\chapter{Language Examples}
+ \doxysection{Python Docstring Example}\label{python_example}\hypertarget{python_example}{}
+ \begin{DoxygenSubAppendix}
+ \subinputfrom{../html/examples/docstring/latex/}{refman_doc}
+ \end{DoxygenSubAppendix}
+ \doxysection{Python Example}\label{py_example}\hypertarget{py_example}{}
+ \begin{DoxygenSubAppendix}
+ \subinputfrom{../html/examples/pyexample/latex/}{refman_doc}
+ \end{DoxygenSubAppendix}
+ \doxysection{VHDL Example}\label{vhdl_example}\hypertarget{vhdl_example}{}
+ \begin{DoxygenSubAppendix}
+ \subinputfrom{../html/examples/mux/latex/}{refman_doc}
+ \end{DoxygenSubAppendix}
+ \doxysection{Tcl Example}\label{tcl_example}\hypertarget{tcl_example}{}
+ \begin{DoxygenSubAppendix}
+ \subinputfrom{../html/examples/tclexample/latex/}{refman_doc}
+ \end{DoxygenSubAppendix}
\chapter{Class Example}\label{class_example}\hypertarget{class_example}{}
\subinputfrom{../html/examples/class/latex/}{refman_doc}
@@ -178,8 +208,6 @@ Written by Dimitri van Heesch\\[2ex]
\subinputfrom{../html/examples/file/latex/}{refman_doc}
\chapter{Fn Example}\label{fn_example}\hypertarget{fn_example}{}
\subinputfrom{../html/examples/func/latex/}{refman_doc}
-\chapter{Javadoc Banner Example}\label{javadoc_banner_example}\hypertarget{javadoc_banner_example}{}
-\subinputfrom{../html/examples/javadoc-banner/latex/}{refman_doc}
\chapter{Overload Example}\label{overload_example}\hypertarget{overload_example}{}
\subinputfrom{../html/examples/overload/latex/}{refman_doc}
\chapter{Page Example}\label{page_example}\hypertarget{page_example}{}