Correct documentation mistakes in double.h and long_double.h

[LeoValque]

Release Management

• Affected package(s):
• Issue(s) solved (if any): fix Discrepancy in documentation of "float.h", "double.h" and "long_double.h" #7781 documentation of "int.h" and "long_long.h" #7782
• Feature/Small Feature (if any):
• Link to compiled documentation (obligatory for small feature) wrong link name to be changed
• License and copyright ownership:

[MaelRL]

It should even be FieldWithKthRoot, and not just FieldWithSqrt.

[albert-github]

Note a possible related issue is #7782

[LeoValque]

I did the modification, now the PR also solved issue 7782

[albert-github]

I don't yet see a change for int.h which look to me still a bit out of sync.

[albert-github]

Are the above lines still necessary or should they be reformulated?

[MaelRL]

that documentation page (see https://doc.cgal.org/latest/Number_types/int_8h.html) is not only for int, but also for short int and long int. It's not the documentation of a specific type like the others but of a header. Looking at the complete doc, I would have in fact gone the opposite way and removed all the cgalModels from these header documentations...

[LeoValque]

I did the suggestion of Mael, now there is only one sentence instead of four identicals.

[albert-github]

Shouldn't there be something like:

\cgalModels{RealEmbeddable,EuclideanRing}

as well, so it is consistent with the other files?

I think the \cgalModels{RealEmbeddable,EuclideanRing} is good to have as you see it at once and don't have to look through the text (although this is quite small in this case)

[LeoValque]

I aggry I understand the suggestion of mael as removing the three sentences "int is model of ..., short int is model of ..., ..., long int is model of ...".
I think it is good not to waste too much energy on these very small files. If you think that the actual change does not miss anything important, we can close the case.

[albert-github]

I think it is good not to waste too much energy on these very small files.

I understand what you are saying, but consistency is a great thing, quite often the first impression that a user gets is through the documentation. Also consistency can make things easier in the future. So it looks like wasting time but I think it pays off in the long run.

[lrineau]

\cgalModels{RealEmbeddable,EuclideanRing} displays:

Is model of

• EuclideanRing
• RealEmbeddable

That is appropriate for a documentation page about one single entity. But here CGAL/int.h is about multiple integral types and \cgalModels cannot be used, unfortunately.

[albert-github]

is it just the word "Is" that should be "Are" or is it more fundamental?

• In the first case a second ALIASES would do.
• In the fundamental case I don't see a quick solution (I don't need the fundamental explanation).