| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
|
|
| |
When generating the doxygen documentation we see that::
- the top rule is completely in uppercase (is OK in regular doxygen documentation)
- the renew of the was done at the wrong place
|
|
|
|
| |
Bringing the doxywizard documentation up to date with the current version.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
In the log file of the generated doxygen manual we see warnings like:
```
pdfTeX warning (ext4): destination with the same identifier (name{figure.22.1})
has been already used, duplicate ignored
\AtBegShi@Output ...ipout \box \AtBeginShipoutBox
\fi \fi
```
(this pull request was also triggered by: https://stackoverflow.com/questions/64328597/pdftex-warning-saying-about-duplicate-figures)
The solution is found by means of: https://tex.stackexchange.com/questions/566677/multiple-use-of-figure-number-ext4-warning/ in short:
> The hyperref package patches \caption so \H@refstepcounter is used instead of \refstepcounter.
The definition isn't necessary in `manual.sty` as the `doxygen_manual.tex` includes `doxygen.sty`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
In the doxygen pdf manual we see that on the first page of each chapter the footer is missing, the same occurs in the "normal" documentation generated by doxygen.
References:
- https://tex.stackexchange.com/questions/566034/footer-ruler-on-first-page-in-fancyhdr-with-book
- https://tex.stackexchange.com/questions/566056/footer-ruler-on-first-page-in-fancyhdr-with-book-but-not-in-part-part/
Code changes ("normal" documentation):
- latexgen.cpp changes required for the "normal" documentation
Code changes (doxygen manual)
- doxygen_manual.sty, remove word "Part" for the Appendices.
- manual.sty changes like for "normal" documentation plus patching part in case of the `\part` (here we don't want the footer or header)
|
|
|
|
|
| |
- patch should only be applied to images.
- added doxyfigcaption to manual.sty for completeness, when in future a table with an image and caption might appear in the documentation.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* use configure_files to avoid different $ semantics when COMMAND lines
are expanded in build files. ($$var vs. \$var)
* nmake/gmake no longer needed by cmake, when building doc.
* explicitly copy doc files into build directory to make it clear what
files each build stage uses.
Documentation can be built with:
mkdir build/ && cd $_
cmake -Dbuild_doc=1 .. # add -G"NMake Makefiles" for nmake
make docs # this builds doxygen first
v3: replace file(COPY) with proper generated file tagging.
v2: Remove option to build documentation independently from doxygen.
tested on linux(gmake) and windows(nmake) [thanks albert]
|
|
|