| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
| |
Shall extra explanation in the documentation.
|
| |
|
|
|
|
|
|
| |
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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Due to a recent change in the new distribution of LaTeX in the handling of the "input" commands we get the error like:
```
Appendix D.
(../html/examples/group/latex/refman_doc.tex (../html/examples/group/latex//gro
up__group1.tex) [243]
! I can't write on file `../html/examples/group/latex//group__group2.aux'.
\@include ...mmediate \openout \@partaux "#1.aux"
\immediate \write \@partau...
l.3 \include{group__group2}
Please type another output file name
! Emergency stop.
\@include ...mmediate \openout \@partaux "#1.aux"
\immediate \write \@partau...
l.3 \include{group__group2}
*** (job aborted, file error in nonstop mode)
```
The problem is that now an intermediate file is written to `../html/examples/group/latex//group__group2.aux` that was written in the older distributions as `./group__group2.aux`, so in the current directory.
Writing to sub directories of the current directory is possible but it is not allowed (unless special, dangerous, options are used) to write to directories outside tgese directories.
(see also: https://tex.stackexchange.com/questions/575120/problem-writing-aux-file)
This fix writes the examples in subdirectories in the latex directory and not under the, parallel, html directory. This means also that there is a cleaner and clearer distinction between the html and latex output.
|
|
|
|
|
| |
This is a follow-up on pull request #8199 (Have build of doxygen documentation fail on warnings.) and #8197 (issue #8023 Add option to exit with non-zero exit code on warnings even if WARN_AS_ERROR is OFF).
These were 2 independent situation, but as with #8197 incor[porated into doxygen it is no possible to extend #8199 to fail but at present all warnings of the first (sub-)task that fails.
|
|\
| |
| | |
Have build of doxygen documentation fail on warnings.
|
| |
| |
| |
| |
| | |
Currently when running doxygen to create its documentation no error is given when a warning is generated, so the warning might go unnoticed.
By setting `WARN_AS_ERROR = YES` the generation will stop and when build on CI systems a build also fails
|
| |
| |
| |
| |
| | |
The link to mathjax is not correct anymore (config.xml), the latest version points to version 3.0 and here there is no output.html either. Setting it fixed to the 2.7 version.
The other corrected links are just about redirections that are otherwise done.
|
| |
| |
| |
| | |
was also removed (hope this is ok, was a default setting). Closes #8212
|
|\ \
| | |
| | | |
Exclude markdown mapped documentation files from Files list
|
| |/
| |
| |
| | |
Update of documentation
|
|\ \
| | |
| | | |
Making the use of DOT_CLEANUP more transparent
|
| |/
| |
| |
| |
| | |
- The setting `DOT_CLEANUP` is not only used for `dot` files but also for temporary `msc` and `plantuml` files, though this was not clear from the documentation.
- For the docbook output format the removal of the `dot` and `msc` files was not don like in the output formats html / LatTeX / rtf.
|
|/
|
|
|
|
| |
- Removing the `txt` and `doc` extension from the default list of `FILE_PATTERNS
- Updating documentation
- Incorrect parsing for the doxywizard of some \ref items (i.e. when the description contains a space, made compatible again with that happens in configgen.py).
|
|
|
|
|
|
|
|
|
| |
At the top of the chapter describing the commands there is a list with described commands, here the commands:
```
\noop
\static
```
were missing.
|
| |
|
| |
|
|
|
|
| |
Bringing the doxywizard documentation up to date with the current version.
|
|
|
|
| |
The syntax of the Windows Powershell differs from other shells, so an example is added to the faq section
|
|
|
|
| |
Small correction in documentation.
|
|
|
|
|
| |
In case of a sequence of hyphens the documentation was incomplete.
(found during implementation of "Miscounting in markdown in case of a horizontal ruler", #8115)
|
|\
| |
| | |
Warning about duplicate figure numbers in LaTeX
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
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`
|
|/
|
|
|
|
|
|
| |
When we look at images in documents we see for a number of images a big amount of white space around the image.
This is e.g. the case in the doxygen manual at page 99 of the 1.8.20 version.
- using `\raggedbottom` sees to it that the space inside the page is removed (there might be some white space when the next image doesn't fit anymore. (See https://tex.stackexchange.com/questions/566779/placing-figures-on-a-fixed-place-without-lot-of-space-around-it)
- use `\centering` instead of `\begin{center}` as the center environment adds some extra white space (see a comment with the question, on a different subject though: https://stackoverflow.com/questions/64328597/pdftex-warning-saying-about-duplicate-figures#comment113772445_64328597)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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)
|
|
|
|
|
|
|
|
|
| |
Looks like the documentation update after
> Commit: 10787eed95266bb1a13c892fe4cf5a695dac1559 [10787ee]
> Date: Friday, May 15, 2020 11:28:16 AM
> Refactoring
has not been done.
|
| |
|
|
|
|
|
|
| |
At some places Python version 2.6 was still mentioned, made uniform to 2.7 everywhere.
(Is already a bit dubious as of January 1st, 2020 Python 2.7 will reached the end of its life., but still a lot will have Python 2.7 by default).
|
| |
|
|
|
|
| |
Small spelling correction as found by spellcheck through Fossies
|
|
|
|
|
|
|
|
|
| |
- make `GLOB` for language files consistent with `GLOB` usage in e.g. `src`
- make building of `language.doc ` depending on the language files as well
- don't copy translator and other input files and handle this also in translator.py
- update documentation
(Found after Swedish language was updated and tried to build documentation on a non new directory)
|
|\
| |
| | |
Using Python docstrings
|
| |
| |
| |
| |
| | |
- making documentation a bit clearer
- add configuration setting to have docstrings not as preformatted text but as normal documentation (default remains preformatted).
|
| |
| |
| |
| | |
There were a few logical errors in the changelog , corrected.
|
| | |
|
| | |
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
- Changed \_linebr to \ilinebr
- \ilinebr is now also passed to doctokenizer
- Also fixes issue #7493 regarding \snippet inside markdown tables and
dealing with wrong line on issues detected by docparser after a
markdown table.
- Added function tracing to markdown (enabled with -d markdown in a
debug build)
|
| |
| |
| |
| |
| |
| |
| | |
The 5th Edition / December 2017 of https://www.ecma-international.org/publications/files/ECMA-ST/ECMA-334.pdf
has the XML commands in Appendix D
Fix issue Typo in xmlcmds.doc XML tags moved to Appendix D of Ecma-334 #7855
https://github.com/doxygen/doxygen/issues/7855
|
| |
| |
| |
| | |
Give a meaningful fatal error when the pdf does not exists (when it exists automatically also the html directory with content exists).
Give a meaningful fatal error when the chm does not exists.
|
| |
| |
| | |
Small documentation consistency.
|
| | |
|
| | |
|
|\ \
| | |
| | | |
Link fixed in documentation
|
| | | |
|
| | |
| | |
| | | |
Normal users of github cannot set labels to issues.
|
|/ / |
|
| | |
|
| | |
|
| | |
|
| |
| |
| |
| |
| | |
- there were still references to Tcl
- 2 entries were accidentally removed from the table with fiel extensions.
|