Due to an incompatibility change in doxygen (see 2a62c19755 (commitcomment-150534822)) it is necessary to add the setting for `FULL_SIDEBAR` to the setup of the CGAL documentation.
Correction of incorrect usage of LaTeX in formulas and bibliography
altough MatHJax and bibtex.pl doesn't always signal it.
- Incorrect biblio entry (missing `,` and `}`)
- Documentation/doc/biblio/geom.bib
- ` ` is not correct LaTeX has to be `~`
-
Arrangement_on_surface_2/doc/Arrangement_on_surface_2/Arrangement_on_surface_2.txt
- Documentation/doc/Documentation/Developer_manual/Chapter_intro.txt
- Incorrect formula regarding usage of `\left` and `\right` (also
signaled by MathJax
-
Arrangement_on_surface_2/doc/Arrangement_on_surface_2/Arrangement_on_surface_2.txt
- `DeclareMathOperator` is a command that should be in the preamble,
alternatively the command `\operatorname` can be used explicitly (as
done here as it is only used once)
-
Kinetic_surface_reconstruction/doc/Kinetic_surface_reconstruction/Kinetic_surface_reconstruction.txt
- Latex has problems with `_` in a `text...` command so it should be
escaped though this gives problems with MathJax hence the extra hook.
MathJax reference:
https://groups.google.com/g/mathjax-users/c/wSh6-hSIUpQ/m/KmzZhQQGslgJ
- Documentation/doc/resources/1.10.0/CGAL_mathjax.js
- Documentation/doc/resources/1.8.13/CGAL_mathjax.js
- Documentation/doc/resources/1.9.6/CGAL_mathjax.js
- Weights/include/CGAL/Weights/authalic_weights.h
- The `&` in the bibliography has to be escaped
- the doxygen command `\f[` should not be used to directly change the environment, for this the doxygen command `\f{` exists.
Correction of incorrect usage of LaTeX in formulas and bibliography altough MatHJax and bibtex.pl doesn't always signal it.
- Incorrect biblio entry (missing `,` and `}`)
- Documentation/doc/biblio/geom.bib
- ` ` is not correct LaTex has to be `~`
- Arrangement_on_surface_2/doc/Arrangement_on_surface_2/Arrangement_on_surface_2.txt
- Documentation/doc/Documentation/Developer_manual/Chapter_intro.txt
- Incorrect formula regarding usage of `\left` and `\right` (also signaled by MathJax
- Arrangement_on_surface_2/doc/Arrangement_on_surface_2/Arrangement_on_surface_2.txt
- `DeclareMathOperator` is a command that should be in the preamble, alternatively the command `\operatorname` can be used explicitly (as done here as it is only used once)
- Kinetic_surface_reconstruction/doc/Kinetic_surface_reconstruction/Kinetic_surface_reconstruction.txt
- Latex has problems with `_` in a `text...` command so it should be escaped though this gives problems with MathJax hence the extra hook.
MathJax reference: https://groups.google.com/g/mathjax-users/c/wSh6-hSIUpQ/m/KmzZhQQGslgJ
- Documentation/doc/resources/1.10.0/CGAL_mathjax.js
- Documentation/doc/resources/1.8.13/CGAL_mathjax.js
- Documentation/doc/resources/1.9.6/CGAL_mathjax.js
- Weights/include/CGAL/Weights/authalic_weights.h
## Summary of Changes
- Changed `PUBLIC` to `PRIVATE` in the `target_link_libraries()`
- ~~Link against `Boost::<COMPONENT>`~~ as we do more than just linking
and must use the `CGAL::_.._support`
- Use `target_compile_definitions()` and `add_compile_definitions()`
More to be done.
## Release Management
* Affected package(s): all
* Issue(s) solved (if any): fix one item of #4815
* License and copyright ownership: unchanged
The problem surfaced between the releases CGAL 5.3.2 and CGAL 5.4.4.
The "Documentation/doc/Documentation/Developer_manual/create_and_use_a_cmakelist.txt" had not been adjusted for the changes in "Surface_mesh/examples/Surface_mesh/CMakeLists.txt" i.e.
the changes in its structure and also during the change Qt5 -> Qt6 this was not detected.
In the header files it was mentioned:
```
<!-- This should probably be an extrastylesheet instead of hardcoded. -->
<link href="$relpath$../Manual/cgal_stylesheet.css" rel="stylesheet" type="text/css" />
$extrastylesheet
```
this is now effectuated with this PR.
Sébastien Loriot
albert-github
Laurent Rineau
Sven Oesau
Andreas Fabri