In #5226 we already fixed a problem regarding the subtle interaction between the `cgaAdvancedEnd` command and table rows / columns.
In this PR a subtle interaction between the `\cgalAdvancedEnd` and the `pre` command is solved.
xmllint gave the following type warning:
```
Periodic_2_triangulation_2/classCGAL_1_1Periodic__2__triangulation__2.html:1418: parser error : Opening and ending tag mismatch: dd line 1418 and div
"This is an advancedSurface_mesh_deformation function.">is_triangulation_in_1_sheet()</a></code> </div>
```
this type of warning appeared for the packages:
- Periodic_2_triangulation_2
- Point_set_3
- TDS_3
- Triangulation
- Triangulation_2
for the package Surface_mesh_skeletonization we again saw a warning like:
```
Surface_mesh_skeletonization/classCGAL_1_1Mean__curvature__flow__skeletonization.html:519: parser error : Opening and ending tag mismatch: td line 519 and div
raph_traits<TriangleMesh>::vertex_descriptor</code> as value type. </div>
```
this is also fixed with this PR.
- use `\cgalPckAuthor` in case of one author
- use of `\cgalPckAuthors` in case of multiple authors
- using in case of multiple authors always `, and `
- in the 1.9.6 `BaseDoxyfile.in` let the `\cgalPckAuthors` point to `\cgalPckAuthor` to get consistent output (not done for other versions as in the past the `ALIASES` could not call one another).
Implemented:
- no extra "Refines" page
- Refines on one line
- Refines always in code style
- `2 arguments` -> `two arguments` (for consistency
- added also the `\qualifier`
Implemented in Kernel_23/doc/Kernel_23/Concepts/FunctionObjectConcepts.h
Results a.o.
- doc_output/Kernel_23/classKernel_1_1Circle__2.html
- doc_output/Kernel_23/classKernel_1_1BoundedSide__3.html
Note: due to the fact that this is a test implementation pages outside the scope of Kernel_23/doc/Kernel_23/Concepts/FunctionObjectConcepts.h might not be correct (in respect to code appearance of refines and multiple refines)
In doxygen the setting `HTML_COLORSTYLE` has been introduced with as default `AUTO_LIGHT` but due to the current strategy of CGAL in respect to HTML stylesheets the divider between the treeview and the text is not properly visible anymore. Due to the same strategy the setting to `AUTO_LIGHT` does not make sense for CGAL.
When setting `HTML_COLORSTYLE=LIGHT` the divider is properly visible again.
Based on the problems with the line numbers in some warnings, see review of https://github.com/CGAL/cgal/pull/6688 one of the problems was the `ALIASES` for figures, here we have the code `\latexonly ^^ \endlatexonly` though the code in the `\latexonly` part should be LaTeX commands. Here the "attempted" newline is not necessary at all so the `^^` can be removed leaving an empty `\latexonly` part that can be removed as well.
There are a number of other numbering problems found in https://github.com/CGAL/cgal/pull/6688 but they are on the doxygen side as a proposed pull request https://github.com/doxygen/doxygen/pull/9465 has been submitted.
Update of documentation in respect of code fragments
- making code fragments work in footnotes
- placing some words in in code tags
- completing some words to code tags
- removing some `#` as they are not necessary
- don't show obfuscation code in email
albert-github
Sébastien Loriot
Laurent Rineau
Mael Rouxel-Labbé