From 0ed88e25a69af7aec1acf0b610783f9d02f7739a Mon Sep 17 00:00:00 2001 From: albert-github 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 to proceed.\MessageBreak If that doesn't work, type X 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