Skip to content

Commit

Permalink
More than 26 appendices in LaTeX manual
Browse files Browse the repository at this point in the history
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.
  • Loading branch information
albert-github committed May 23, 2019
1 parent 5c9d812 commit 0ed88e2
Showing 1 changed file with 44 additions and 16 deletions.
60 changes: 44 additions & 16 deletions doc/doxygen_manual.tex
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -147,22 +157,42 @@ \chapter{Modules Example}\label{modules_example}\hypertarget{modules_example}{}
\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}
Expand All @@ -178,8 +208,6 @@ \chapter{File Example}\label{file_example}\hypertarget{file_example}{}
\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}{}
Expand Down

0 comments on commit 0ed88e2

Please sign in to comment.