CGAL / cgal

The public CGAL repository, see the README below
https://github.com/CGAL/cgal#readme
Other
4.86k stars 1.38k forks source link

How to avoid these hyperlinks #8397

Open afabri opened 1 month ago

afabri commented 1 month ago

Issue Details

In the PR #6849 for Isosurfacing we get hyperlinks for Point_3 and Vector_3. Do we have to prevent this using % or can we consider this as a doxygen bug? and should file an issue? Or is that only a problem with the version of doxygen we use in the CI ? Any idea @albert-github ?

Source Code

See here

albert-github commented 1 month ago

On the mentioned page (https://cgal.github.io/6849/v5/Isosurfacing_3/classCGAL_1_1Isosurfacing_1_1Gradient__function__3.html) I see a number of occurrences of Point_3 and of Vector_3 which ones are you referring to?

When looking in the source code, I think, Isosurfacing_3/include/CGAL/Isosurfacing_3/Gradient_function_3.h) at line 56-57 we see once a % (Point_3) and once without (Vector_3) so this looks indeed a bit inconsistent. When we want to link to the "using" on this page the version without % is OK when we don't want this the % is necessary.