From 0ed88e25a69af7aec1acf0b610783f9d02f7739a Mon Sep 17 00:00:00 2001
From: albert-github <albert.tests@gmail.com>
Date: Thu, 23 May 2019 12:40:49 +0200
Subject: 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.
---
 doc/doxygen_manual.tex | 60 ++++++++++++++++++++++++++++++++++++--------------
 1 file 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}{}
-- 
cgit v0.12

