Double use of citation name (#8504)

Based on #8320 and doxygen/doxygen#11157
creating an assertion for builds from scratch when a citation name is
used multiple times.

Author: sloriot

Documentation/doc/scripts/generate_how_to_cite.py

@@ -278,7 +278,9 @@ def main():
         encoding="utf-8",
     )
     k = 2
+    citeDic = {}
     for line in f:
+        foundDouble=False
         match = pattern.match(line)
         if match:
             pkg = match.group(1)
@@ -304,6 +306,10 @@ def main():
                 match = pattern_bib.match(pkg_line)
                 if match:
                     bib = match.group(1)
+                    if bib in citeDic:
+                        foundDouble=True
+                    else:
+                        citeDic[bib] = pkg
                     continue
             assert len(bib) > 0, "Did you forget a \\cgalPkgBib{} in %r?" % filename
             assert len(authors) > 0, (
@@ -313,6 +319,11 @@ def main():
                 "Did you forget the anchor in \\cgalPkgDescriptionBegin{} in %r?"
                 % filename
             )
+            assert not foundDouble, (
+                """Multiple use of citation name '{}' package '{}'
+                first occurence package '{}'
+                """.format(bib,pkg,citeDic[bib])
+            )
             result_txt += gen_txt_entry(title, authors, bib, anchor, k)
             # convert title and author to bibtex format
             title = protect_upper_case(title)

Triangulation_on_hyperbolic_surface_2/doc/Triangulation_on_hyperbolic_surface_2/PackageDescription.txt

@@ -27,7 +27,7 @@
 \cgalPkgShortInfoBegin
 \cgalPkgSince{6.1}
 \cgalPkgDependsOn{\ref PkgCombinatorialMaps}
-\cgalPkgBib{cgal:y-t2}
+\cgalPkgBib{cgal:ddpt-thss}
 \cgalPkgLicense{\ref licensesGPL "GPL"}
 \cgalPkgDemo{2D Triangulations on Hyperbolic Surfaces,nofilefornow.zip}
 \cgalPkgShortInfoEnd