"
ALIASES += "cgalPkgSince{1}=Introduced in: \cgal \1 "
ALIASES += "cgalPkgDependsOn{1}=Depends on: \1 "
ALIASES += "cgalPkgLicense{1}=License: \1 "
-ALIASES += "cgalPkgDemo{2}=Windows Demo:\1 Common Demo Dlls:dlls "
-ALIASES += "cgalPkgDemo{4}=Windows Demos:\1, \3 Common Demo Dlls:dlls "
-ALIASES += "cgalPkgDemo{6}=Windows Demos:\1, \3, \5 Common Demo Dlls:dlls "
+ALIASES += "cgalPkgDemo{2}=Windows Demo:\1 Common Demo Dlls:dlls "
+ALIASES += "cgalPkgDemo{4}=Windows Demos:\1, \3 Common Demo Dlls:dlls "
+ALIASES += "cgalPkgDemo{6}=Windows Demos:\1, \3, \5 Common Demo Dlls:dlls "
ALIASES += "cgalPkgDescriptionEnd="
@@ -279,7 +279,7 @@ ALIASES+= "cgalModifEnd=\htmlonly \endhtmlonly \latexonly END MODIFICATIO
# this alias controls linking to the how to cite page, it is also
# responsible for adding the -YY{a,b} suffix to a cite
-ALIASES += "cgalPkgBib{1}=BibTeX:\1-13b "
+ALIASES += "cgalPkgBib{1}=BibTeX:\1-${CGAL_RELEASE_YEAR_ID} "
ALIASES += "cgalFootnote{1}=\1"
ALIASES += "cgalAutoToc=\htmlonly \endhtmlonly"
diff --git a/Documentation/CMakeLists.txt b/Documentation/CMakeLists.txt
index 174cd095192..df29dd88ba8 100644
--- a/Documentation/CMakeLists.txt
+++ b/Documentation/CMakeLists.txt
@@ -108,6 +108,44 @@ if(DOXYGEN_FOUND)
set(CGAL_DOC_HEADER_PACKAGE ${CGAL_DOC_DXY_DIR}/header_package.html)
configure_file(${CMAKE_CURRENT_SOURCE_DIR}/header_package.html ${CGAL_DOC_HEADER_PACKAGE} @ONLY)
+ #Generate the bibtex file
+ #this is needed also for BaseDoxyfile.in
+ if ( ${CMAKE_VERSION} VERSION_GREATER "2.8.10")
+ string(TIMESTAMP CGAL_BUILD_YEAR4 "%Y")
+ string(TIMESTAMP CGAL_BUILD_YEAR2 "%y")
+ string(TIMESTAMP CGAL_BUILD_MONTH "%m")
+ else()
+ MESSAGE(STATUS "You're using an old version of CGAL, date in bibtex files will be incorrect")
+ set(CGAL_BUILD_YEAR4 "2000")
+ set(CGAL_BUILD_YEAR2 "00")
+ set(CGAL_BUILD_MONTH "1")
+ endif()
+
+ if (${CGAL_BUILD_MONTH} GREATER 6)
+ SET(CGAL_RELEASE_YEAR_ID "${CGAL_BUILD_YEAR2}b")
+ else()
+ SET(CGAL_RELEASE_YEAR_ID "${CGAL_BUILD_YEAR2}a")
+ endif()
+
+ configure_file(${CMAKE_CURRENT_SOURCE_DIR}/resources/how_to_cite_cgal.bib.in
+ ${CMAKE_BINARY_DIR}/how_to_cite_cgal.bib)
+
+ find_program(BIBTEX2HTML_EXECUTABLE bibtex2html DOC "Path to bibtex2html")
+ find_program(SH_EXECUTABLE sh DOC "Path to sh")
+ if (BIBTEX2HTML_EXECUTABLE AND SH_EXECUTABLE)
+ execute_process(COMMAND ${SH_EXECUTABLE}
+ ${CMAKE_CURRENT_SOURCE_DIR}/scripts/makebiblio
+ ${CMAKE_BINARY_DIR}/how_to_cite_cgal.bib
+ ${BIBTEX2HTML_EXECUTABLE}
+ OUTPUT_QUIET
+ ERROR_QUIET) #bibtex2html also prints info in stderr
+ else()
+ MESSAGE(STATUS "bibtex2html or sh missing, using default how_to_cite files")
+ configure_file(${CMAKE_CURRENT_SOURCE_DIR}/resources/how_to_cite.html.default ${CMAKE_BINARY_DIR}/how_to_cite.html COPYONLY)
+ configure_file(${CMAKE_CURRENT_SOURCE_DIR}/resources/how_to_cite_cgal.txt.default ${CMAKE_BINARY_DIR}/how_to_cite_cgal.txt COPYONLY)
+ endif()
+ ## end bibtex configuration
+
configure_file(${CMAKE_CURRENT_SOURCE_DIR}/BaseDoxyfile.in ${CGAL_DOC_DXY_DIR}/BaseDoxyfile)
set(CGAL_DOC_DOXY_DEFAULT "${CGAL_DOC_DXY_DIR}/BaseDoxyfile")
@@ -124,7 +162,6 @@ if(DOXYGEN_FOUND)
configure_doxygen_package(${package})
endforeach()
-
# hard-coded. this is not recognized as a package by the
# build-system, because it doesn't have a package_description subdir.
configure_doxygen_package("Miscellany")
diff --git a/Documentation/biblio/README.txt b/Documentation/biblio/README.txt
deleted file mode 100644
index ffaa8568f03..00000000000
--- a/Documentation/biblio/README.txt
+++ /dev/null
@@ -1,30 +0,0 @@
-# How To Cite #
-
-This document explains how the "How To Cite" and the htmlized bibtex
-file are generated and how they are used by the documentation.
-
-## Generation ##
-
- makebiblio manual-x.y.bib
-
-generates the files:
-
-- how\_to\_cite.html (HTMLized version of the cgal bibtex)
-- how\_to\_cite_cgal.txt (the page with the table linking
- to the bibtex sections and back to the packages)
-
-## What Is Done With Them ##
-
-The first is included as an HTML_EXTRA_FILE in the main CGAL Doxygen
-project. The second is parsed as a normal page and linked accessible
-through the navbar of the documentation.
-
-## Controlling the cite suffix ##
-
-A suffix of the form YY{a|b} is appended through the cgalbib defined
-in the main Doxyfile. If the bib receive a version bumb and are
-regenerated the config has to be adapted with the new value.
-
-## What's missing? ##
-
-A script to bumb a manual-X.Y.bib file to manual-X.Y+1.bib file including the year.
diff --git a/Documentation/biblio/how_to_cite.html b/Documentation/biblio/how_to_cite.html
deleted file mode 100644
index c06984c6fdd..00000000000
--- a/Documentation/biblio/how_to_cite.html
+++ /dev/null
@@ -1,974 +0,0 @@
-
manual-4.3.bib
-@book{cgal:eb-13b,
- title = {{CGAL} User and Reference Manual},
- author = {{The CGAL Project}},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- year = 2013,
- url = {http://doc.cgal.org/4.3/Manual/packages.html}
-}
-
-@incollection{cgal:bht-ak-13b,
- author = {Eric Berberich and Michael Hemmer and Michael Kerber and Sylvain Lazard and Luis Pe{\~n}aranda and Monique Teillaud},
- title = {Algebraic Kernel},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgAlgebraicKerneldSummary},
- year = 2013
-}
-
-
-
-@incollection{cgal:hhkps-nt-13b,
- author = {Michael Hemmer and Susan Hert and Lutz Kettner and Sylvain Pion and Stefan Schirra},
- title = {Number Types},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgNumberTypesSummary},
- year = 2013
-}
-
-@incollection{cgal:bfghhkps-lgk23-13b,
- author = {Herv{\'e} Br{\"o}nnimann and Andreas Fabri and Geert-Jan Giezeman and Susan Hert and Michael Hoffmann and Lutz Kettner and Sylvain Pion and Stefan Schirra},
- title = {{2D} and {3D} Geometry Kernel},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgKernel23Summary},
- year = 2013
-}
-
-@incollection{cgal:wfzh-a2-13b,
- author = {Ron Wein and Eric Berberich and Efi Fogel and Dan Halperin and Michael Hemmer and Oren Salzman and Baruch Zukerman},
- title = {{2D} Arrangements},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgArrangement2Summary},
- year = 2013
-}
-
-@incollection{cgal:kmz-isiobd-13b,
- author = {Lutz Kettner and Andreas Meyer and Afra Zomorodian},
- title = {Intersecting Sequences of {dD} Iso-oriented Boxes},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgBoxIntersectionDSummary},
- year = 2013
-}
-
-
-
-@incollection{cgal:fghhs-bv-13b,
- author = {Kaspar Fischer and Bernd G{\"a}rtner and Thomas Herrmann and Michael Hoffmann and Sven Sch{\"o}nherr},
- title = {Bounding Volumes},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgBoundingVolumesSummary},
- year = 2013
-}
-
-
-
-@incollection{cgal:fgsw-lqps-13b,
- author = {Kaspar Fischer and Bernd G{\"a}rtner and Sven Sch{\"o}nherr and Frans Wessendorp},
- title = {Linear and Quadratic Programming Solver},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgQPSolverSummary},
- year = 2013
-}
-
-@incollection{cgal:fghhs-od-13b,
- author = {Kaspar Fischer and Bernd G{\"a}rtner and Thomas Herrmann and Michael Hoffmann
- and Sven Sch{\"o}nherr},
- title = {Optimal Distances},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgOptimalDistancesSummary},
- year = 2013
-}
-
-
-
-@incollection{cgal:f-i-13b,
- author = {Julia Fl{\"o}totto},
- title = {{2D} and Surface Function Interpolation},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgInterpolation2Summary},
- year = 2013
-}
-
-@incollection{cgal:cfw-cbgl-13b,
- author = {Andreas Fabri and Fernando Cacciola and Ron Wein},
- title = {{CGAL} and the {Boost} Graph Library},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgBGLSummary},
- year = 2013
-}
-
-
-
-@incollection{cgal:fs-cbpm-13b,
- author = {Andreas Fabri and Laurent Saboret},
- title = {{CGAL} and {Boost} Property Maps},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgProperty_mapSummary},
- year = 2013
-}
-
-@incollection{cgal:hkpw-se-13b,
- author = {Michael Hoffmann and Lutz Kettner and Sylvain Pion and Ron Wein},
- title = {STL Extensions for {CGAL}},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgStlExtensionSummary},
- year = 2013
-}
-
-
-
-@incollection{cgal:dksy-hc-13b,
- author = {Olivier Devillers and Lutz Kettner and Michael Seel and Mariette Yvinec},
- title = {Handles and Circulators},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgHandlesAndCirculatorsSummary},
- year = 2013
-}
-
-
-
-@incollection{cgal:dhhk-gog-13b,
- author = {Olivier Devillers and Susan Hert and Michael Hoffmann and Lutz Kettner and Sven Sch{\"o}nherr},
- title = {Geometric Object Generators},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgGeneratorsSummary},
- year = 2013
-}
-
-
-
-@incollection{cgal:kps-pthum-13b,
- author = {Lutz Kettner and Sylvain Pion and Michael Seel},
- title = {Profiling Tools Timers, Hash Map, Union-find, Modifiers},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgProfilingToolsSummary},
- year = 2013
-}
-
-
-
-@incollection{cgal:fgk-ios-13b,
- author = {Andreas Fabri and Geert-Jan Giezeman and Lutz Kettner},
- title = {IO Streams},
- publisher = {{CGAL Editorial Board}},
- edition = {{4.3}},
- booktitle = {{CGAL} User and Reference Manual},
- url = {http://doc.cgal.org/4.3/Manual/packages.html#PkgIOstreamsSummary},
- year = 2013
-}
-
+@incollection{cgal:bht-ak-00a,
+ author = {Eric Berberich and Michael Hemmer and Michael Kerber and Sylvain Lazard and Luis Pe{\~n}aranda and Monique Teillaud},
+ title = {Algebraic Kernel},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgAlgebraicKerneldSummary},
+ year = 2000
+}
+
+
+
+@incollection{cgal:hhkps-nt-00a,
+ author = {Michael Hemmer and Susan Hert and Lutz Kettner and Sylvain Pion and Stefan Schirra},
+ title = {Number Types},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgNumberTypesSummary},
+ year = 2000
+}
+
+@incollection{cgal:bfghhkps-lgk23-00a,
+ author = {Herv{\'e} Br{\"o}nnimann and Andreas Fabri and Geert-Jan Giezeman and Susan Hert and Michael Hoffmann and Lutz Kettner and Sylvain Pion and Stefan Schirra},
+ title = {{2D} and {3D} Geometry Kernel},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgKernel23Summary},
+ year = 2000
+}
+
+@incollection{cgal:wfzh-a2-00a,
+ author = {Ron Wein and Eric Berberich and Efi Fogel and Dan Halperin and Michael Hemmer and Oren Salzman and Baruch Zukerman},
+ title = {{2D} Arrangements},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgArrangement2Summary},
+ year = 2000
+}
+
+@incollection{cgal:kmz-isiobd-00a,
+ author = {Lutz Kettner and Andreas Meyer and Afra Zomorodian},
+ title = {Intersecting Sequences of {dD} Iso-oriented Boxes},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgBoxIntersectionDSummary},
+ year = 2000
+}
+
+
+
+@incollection{cgal:fghhs-bv-00a,
+ author = {Kaspar Fischer and Bernd G{\"a}rtner and Thomas Herrmann and Michael Hoffmann and Sven Sch{\"o}nherr},
+ title = {Bounding Volumes},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgBoundingVolumesSummary},
+ year = 2000
+}
+
+
+
+@incollection{cgal:fgsw-lqps-00a,
+ author = {Kaspar Fischer and Bernd G{\"a}rtner and Sven Sch{\"o}nherr and Frans Wessendorp},
+ title = {Linear and Quadratic Programming Solver},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgQPSolverSummary},
+ year = 2000
+}
+
+@incollection{cgal:fghhs-od-00a,
+ author = {Kaspar Fischer and Bernd G{\"a}rtner and Thomas Herrmann and Michael Hoffmann
+ and Sven Sch{\"o}nherr},
+ title = {Optimal Distances},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgOptimalDistancesSummary},
+ year = 2000
+}
+
+
+
+@incollection{cgal:f-i-00a,
+ author = {Julia Fl{\"o}totto},
+ title = {{2D} and Surface Function Interpolation},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgInterpolation2Summary},
+ year = 2000
+}
+
+@incollection{cgal:cfw-cbgl-00a,
+ author = {Andreas Fabri and Fernando Cacciola and Ron Wein},
+ title = {{CGAL} and the {Boost} Graph Library},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgBGLSummary},
+ year = 2000
+}
+
+
+
+@incollection{cgal:fs-cbpm-00a,
+ author = {Andreas Fabri and Laurent Saboret},
+ title = {{CGAL} and {Boost} Property Maps},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgProperty_mapSummary},
+ year = 2000
+}
+
+@incollection{cgal:hkpw-se-00a,
+ author = {Michael Hoffmann and Lutz Kettner and Sylvain Pion and Ron Wein},
+ title = {STL Extensions for {CGAL}},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgStlExtensionSummary},
+ year = 2000
+}
+
+
+
+@incollection{cgal:dksy-hc-00a,
+ author = {Olivier Devillers and Lutz Kettner and Michael Seel and Mariette Yvinec},
+ title = {Handles and Circulators},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgHandlesAndCirculatorsSummary},
+ year = 2000
+}
+
+
+
+@incollection{cgal:dhhk-gog-00a,
+ author = {Olivier Devillers and Susan Hert and Michael Hoffmann and Lutz Kettner and Sven Sch{\"o}nherr},
+ title = {Geometric Object Generators},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgGeneratorsSummary},
+ year = 2000
+}
+
+
+
+@incollection{cgal:kps-pthum-00a,
+ author = {Lutz Kettner and Sylvain Pion and Michael Seel},
+ title = {Profiling Tools Timers, Hash Map, Union-find, Modifiers},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgProfilingToolsSummary},
+ year = 2000
+}
+
+
+
+@incollection{cgal:fgk-ios-00a,
+ author = {Andreas Fabri and Geert-Jan Giezeman and Lutz Kettner},
+ title = {IO Streams},
+ publisher = {{CGAL Editorial Board}},
+ edition = {{4.4}},
+ booktitle = {{CGAL} User and Reference Manual},
+ url = {http://doc.cgal.org/4.4/Manual/packages.html#PkgIOstreamsSummary},
+ year = 2000
+}
+
Michael Hemmer, Susan Hert, Lutz Kettner, Sylvain Pion, and Stefan Schirra.
Number types.
In %CGAL User and Reference Manual. %CGAL Editorial Board,
- 4.3 edition, 2013.
-[ bib |
-http ]
+ 4.4 edition, 2000.
+[ bib |
+http ]
@@ -109,15 +114,15 @@ Michael Hemmer, Susan Hert, Lutz Kettner, Sylvain Pion, and Stefan Schirra.
Hervé Brönnimann, Andreas Fabri, Geert-Jan Giezeman, Susan Hert,
Michael Hoffmann, Lutz Kettner, Sylvain Pion, and Stefan Schirra.
2D and 3D geometry kernel.
In %CGAL User and Reference Manual. %CGAL Editorial Board,
- 4.3 edition, 2013.
-[ bib |
-http ]
+ 4.4 edition, 2000.
+[ bib |
+http ]
@@ -158,15 +163,15 @@ Hervé Brönnimann, Andreas Fabri, Geert-Jan Giezeman, Susan Hert,
Susan Hert and Stefan Schirra.
3D convex hulls.
In %CGAL User and Reference Manual. %CGAL Editorial Board,
- 4.3 edition, 2013.
-[ bib |
-http ]
+ 4.4 edition, 2000.
+[ bib |
+http ]
@@ -239,15 +244,15 @@ Susan Hert and Stefan Schirra.
Peter Hachenberger.
3D Minkowski sum of polyhedra.
In %CGAL User and Reference Manual. %CGAL Editorial Board,
- 4.3 edition, 2013.
-[ bib |
-http ]
+ 4.4 edition, 2000.
+[ bib |
+http ]
Manuel Caroli and Monique Teillaud.
3D periodic triangulations.
In %CGAL User and Reference Manual. %CGAL Editorial Board,
- 4.3 edition, 2013.
-[ bib |
-http ]
+ 4.4 edition, 2000.
+[ bib |
+http ]
@@ -656,15 +661,15 @@ Manuel Caroli and Monique Teillaud.
Tran Kai Frank Da and Mariette Yvinec.
3D alpha shapes.
In %CGAL User and Reference Manual. %CGAL Editorial Board,
- 4.3 edition, 2013.
-[ bib |
-http ]
+ 4.4 edition, 2000.
+[ bib |
+http ]
@@ -688,15 +693,15 @@ Tran Kai Frank Da and Mariette Yvinec.
Pierre Alliez, Laurent Saboret, and Gael Guennebaud.
Surface reconstruction from point sets.
In %CGAL User and Reference Manual. %CGAL Editorial Board,
- 4.3 edition, 2013.
-[ bib |
-http ]
+ 4.4 edition, 2000.
+[ bib |
+http ]
@@ -784,15 +789,15 @@ Pierre Alliez, Laurent Saboret, and Gael Guennebaud.
Marc Pouget and Frédéric Cazals.
Estimation of local differential properties of point-sampled
surfaces.
In %CGAL User and Reference Manual. %CGAL Editorial Board,
- 4.3 edition, 2013.
-[ bib |
-http ]
+ 4.4 edition, 2000.
+[ bib |
+http ]
@@ -1092,15 +1097,15 @@ Marc Pouget and Frédéric Cazals.
Andreas Fabri, Fernando Cacciola, and Ron Wein.
%CGAL and the Boost graph library.
In %CGAL User and Reference Manual. %CGAL Editorial Board,
- 4.3 edition, 2013.
-[ bib |
-http ]
+ 4.4 edition, 2000.
+[ bib |
+http ]
@@ -1156,15 +1161,15 @@ Andreas Fabri, Fernando Cacciola, and Ron Wein.
Sébastien Loriot and Sylvain Pion.
%CGAL ipelets.
In %CGAL User and Reference Manual. %CGAL Editorial Board,
- 4.3 edition, 2013.
-[ bib |
-http ]
+ 4.4 edition, 2000.
+[ bib |
+http ]
diff --git a/Documentation/biblio/makebiblio b/Documentation/scripts/makebiblio
similarity index 67%
rename from Documentation/biblio/makebiblio
rename to Documentation/scripts/makebiblio
index f17753a9598..7ebef720672 100755
--- a/Documentation/biblio/makebiblio
+++ b/Documentation/scripts/makebiblio
@@ -1,17 +1,7 @@
#!/bin/sh
-if [ ! -x "`which bibtex2html`" ]; then
- echo "You need to install bibtex2html first!"
- exit 1
-fi
-
-if [ ! -f "$1" ]; then
- echo "Usage: makebiblio path/to/manual-x.y.bib"
- echo "Note that the file manual-x.y.bib, with x.y equal to the current version of CGAL"
- echo "should be in the 'Manual' package, in Manual/doc_tex/Manual/..."
- exit 1
-fi
-bibtex2html -nodoc $1
+$2 -nodoc $1
+mv ${1%.bib}.html tmp_array_bib.html
mv ${1%.bib}_bib.html how_to_cite.html
cat > how_to_cite_cgal.txt <<'EOF'
@@ -44,21 +34,20 @@ software.
If you want to cite the %CGAL Library or project as a whole, please
- cite: %CGAL, Computational Geometry Algorithms Library, http://www.cgal.org
-- use the following bibtex entry.
+- use the following bibtex entry.
## Citing the User and Reference Manual ##
If you want to refer to %CGAL manual, please cite the appropriate
entry from the bibliographic entries for individual chapters listed
in the table below.
+
EOF
-footer="*/"
+sed -i "s/how_to_cite_cgal_bib/how_to_cite/g" tmp_array_bib.html
+sed -i "s/CGAL/%CGAL/g" tmp_array_bib.html
+sed -i "s/Kernel/%Kernel/g" tmp_array_bib.html
+sed -i "s/Interval/%Interval/g" tmp_array_bib.html
+sed "s/Matrix/%Matrix/g" tmp_array_bib.html >> how_to_cite_cgal.txt
-sed -e "s|https://cgal.geometryfactory.com/~pmoeller/Doxygen/CGAL.CGAL/html/||g" ${1%.bib}.html | \
- sed -e "s|${1%.bib}_bib.html|how_to_cite.html|g" | \
- sed -e "s| CGAL| %CGAL|g" | sed -e "s|>CGAL|>%CGAL|g" >> how_to_cite_cgal.txt
-echo $footer >> how_to_cite_cgal.txt
-
-echo
-echo "Do not forget to commit, now!"
+echo "*/" >> how_to_cite_cgal.txt
diff --git a/Kernel_23/doc/Kernel_23/CGAL/Bbox_3.h b/Kernel_23/doc/Kernel_23/CGAL/Bbox_3.h
index 6dcdb0ca15c..3dd13dc894a 100644
--- a/Kernel_23/doc/Kernel_23/CGAL/Bbox_3.h
+++ b/Kernel_23/doc/Kernel_23/CGAL/Bbox_3.h
@@ -79,14 +79,14 @@ double zmax() const;
/*!
Returns `xmin()` if `i==0` or `ymin()` if `i==1`
or `zmin()` if `i==2`.
-\pre i<=0 and i<=2
+\pre i>=0 and i<=2
*/
double min(int i) const;
/*!
Returns `xmax()` if `i==0` or `ymax()` if `i==1`
or `zmax()` if `i==2`.
-\pre i==0 and i<=2
+\pre i>=0 and i<=2
*/
double max(int i) const;
diff --git a/Manual/INSTALL b/Manual/INSTALL
deleted file mode 100644
index 87c1097b3a3..00000000000
--- a/Manual/INSTALL
+++ /dev/null
@@ -1,13 +0,0 @@
-========================================================================
-Installation of the Manual package
-========================================================================
-
-In order to be able to create CGAL's manuals you need to do the following:
-
-(1) install the manual conversion tools (available as package Manual_tools
- on the SVN server or from http://www.cgal.org/Members/Manual_tools)
-
-(2) make the cgal_manual script in 'developer_scripts/' accessible via
- the standard execution path.
-
-Follow the directions in the Developers Manual to create a manual.
diff --git a/Manual/README b/Manual/README
deleted file mode 100644
index fa7d376adff..00000000000
--- a/Manual/README
+++ /dev/null
@@ -1,17 +0,0 @@
-========================================================================
-Contents of the directory
-========================================================================
-
-This directory contains:
- README -- this file
- INSTALL -- directions for how to INSTALL this package in order
- to create the manuals and run the tests
-
- doc_tex/ -- directory containing the main tex files for the
- manuals (the "driver"), i.e., those files not
- submitted with packages but needed to create the manual.
- developer_scripts/
- -- directory of scripts used for creating the manual
-
-
-========================================================================
diff --git a/Manual/TO_DO b/Manual/TO_DO
deleted file mode 100644
index 4ab701736a4..00000000000
--- a/Manual/TO_DO
+++ /dev/null
@@ -1,92 +0,0 @@
-Manual/TO_DO
-==================
-
--- Bug Fixes
--- Feature Requests
--- Projects
-
-
-Bug Fixes
-============================================================================
-
--- MAN: Remove the explicit \ccRefPageBegin/End's from my manual pages
- since they are automatically called in the refPage environment [small]
-
-
-Feature Requests
-============================================================================
-
--- DOC: Add to Chapter 2 of Developers Manual a section on the way how
- to build the manuals manually, i.e., without the use of cgal_manual.
- It would a commented version of the output one gets from
- cgal_manual -cmdlog.
-
--- DOC: Add to Chapter 2 of Developers Manual a section on how to handle
- chapters in CGAL Manuals that are assembled from several CGAL packages.
- The problem is the question, whether a package author can test
- his/her package alone. There are some examples in the curren cgal_manual,
- Handle, and STL_Extensions.
-
--- All: Packages can be assembled into different manuals, i.e., cross
- references to other packages might exist or not. In principle, one
- could use the multi-pass assembly of packages in the current way how
- CGAL manuals are built to declare the exisiting packages first and then
- include them, such that packages can check for the existence of other
- packages. Some help can be provided with additional macros.
-
--- TeX: Change page numbers of printed manual to -
- + page per chapter. It simplifies packaging of individual manuals.
- Try just to redefine \thepage. It might not work as smooth as expected
- with the indexing and would turn thus into a project, not a feature
- request. Seek consensus on cgal-develop/cgal-editor for such change.
-
--- TeX, HTML: header/footer are not respected yet. The printed manuals
- have no footer like the HTML manuals yet. Can be added to the wrapper
- file embodied into cgal_manual.
-
--- SRC: Add -v flag to cgal_manual to print commands executed
- (helps in doing it later by hand)
-
--- SRC: Add -debug flag to cgal_manual that prevent temp file from
- being deleted (debug index)
-
--- CHECK: Look into Naming conventions. e.g., "User Manual" of the OpenGL books
-
--- TeX: generate a PostScript and PDF manuals for single sided printers,
- i.e., which do not distinguish between left and right pages. Things
- to check: alignment with paper boundaries, header and footer, and
- the "Class", "Concept", etc., tabs should all be on the right side.
- Suggestion: make this an option of cgal_manual, but the default
- remains double sided, since almost all users will have double sided
- printers these days. We also have to figure out whether we want to
- support all combinations of A4 and letter size paper with single or
- double sided printing on the download page, or if this is an option
- for Andreas GeometryFactory only to offer cumstomized manuals for
- his customers.
-
--- DOC: Remove Use of STL manual
-
--- SRC: Would it be possible to replace the requirement that the Manual/
- directory is placed side by side with the package we want to build the
- doc, by an environment variable (which could default to "../..") ?
- (name it CGAL_MANUAL_DIR, define it to end with .../Manual/ )
-
-
-Projects
-============================================================================
-
--- CHECK: Check what to do with Tutorial/doc_tex, needs reorganization
- to be intergrated into the automatic manual test build. The tutorials
- should be build and tested as all other manuals too.
-
--- SRC: either adapt cgal_manual, or create a new script that works on the
- latest test suite result, and builds a release candidate of the manuals,
- in particular, repackages the files into their proper subdirectories
- before tar'ing. (Check the current release for file organization.)
-
--- SRC: How to support US letter paper at the same time as A4 in PS and PDF?
-
--- CHECK: alternative for creating PDF (some options seem to be missing for
- good font support though, -ups, -Ppdf???)
- ???: dvips -t letter -o pdf_wrapper.ps pdf_wrapper
- ???: ps2pdf pdf_wrapper.ps
diff --git a/Manual/developer_scripts/cgal_manual b/Manual/developer_scripts/cgal_manual
deleted file mode 100755
index dc1292b5121..00000000000
--- a/Manual/developer_scripts/cgal_manual
+++ /dev/null
@@ -1,2102 +0,0 @@
-#! /bin/bash
-
-
-# ============================================================================
-# Copyright (c) 2004 Max-Planck-Institute Saarbruecken (Germany),
-# All rights reserved.
-#
-# This file is part of CGAL (www.cgal.org); you can redistribute it and/or
-# modify it under the terms of the GNU Lesser General Public License as
-# published by the Free Software Foundation; either version 3 of the License,
-# or (at your option) any later version.
-#
-# Licensees holding a valid commercial license may use this file in
-# accordance with the commercial license agreement provided with the software.
-#
-# This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
-# WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-#
-# $URL$
-# $Id$
-#
-#
-# Author(s) : Lutz Kettner
-#
-# ============================================================================
-#
-# Specification: cgal_manual
-# --------------------------
-#
-# It is called in a ./doc_tex/ directory of a CGAL Package or internal release.
-#
-# This script is the driver program for creating CGAL manuals. It makes
-# use of LaTeX, PDFLaTeX, BiBTeX, makeindex, latex_to_html, and other
-# tools to create the PostScript, PDF, and HTML manuals for individual
-# SVN Packages as well as custom Modules. It encodes the conventions of
-# how CGAL manuals are organized and how the general purpose tools need
-# to be called to create the manuals. We specify these conventions here
-# briefly. See the developers manual for more details.
-# Both documentations need to be kept synchronized!
-#
-# - SVN Package:
-#
-# Development unit in CGAL hosted on our SVN server. A package has a
-# fixed directory directory structure. Let's assume the package is
-# called 'Geom', then the documentation must reside in a directory
-# ./doc_tex/ withing the package Geom. Here, individual subdirectories,
-# typically ./Geom/ and ./Geom_ref/, contain the user and the reference
-# manual respectively. The individual subdirectories contain a main.tex
-# that contains the manual chapter, possibly several and possibly using
-# several other input files, but all included with relative paths
-# from the ./doc_tex/ directory, where the tools and this script will
-# run.
-# In general, all individual subdirectories that contain a main.tex
-# are processed. ./doc_tex/*/main.tex and ./doc_tex/*_ref/main.tex are
-# assumed to form corresponding user and reference manual entries in the
-# table of contents.
-# The main.tex files are not stand-alone LaTeX files. They are
-# chapters, i.e., do not contain \begin{document} etc. This script
-# provides the necessary LaTeX wrapper file.
-#
-# - Modules:
-#
-# Presentation unit of modularity towards the user, assembled from
-# SVN packages. For a module of name 'Algo' it is assumed that in the
-# ./doc_tex/ directory exists the necessary LaTeX driver file Algo.tex .
-# This driver is a complete LaTeX file incl. \begin{document} and
-# such. It can in itself then include the various chapters from
-# packages.
-#
-# This script can create individual package documentation given the name of
-# the individual subdirectories in ./doc_tex/. It creates module
-# documentations given the name of the module LaTeX driver file.
-#
-# The default is to create package manuals for all ./*/main.tex files,
-# where ./*/main.tex and corresponding ./*_ref/main.tex are kept in
-# one manual., and for all *_[Mm]anual.tex files for modules.
-#
-# This script can be used in three different environments of CGAL sources.
-# It decides automatically in which situation it is and adapts the necessary
-# search paths for style files and bibliographies.
-#
-# - 1. CGAL Internal Release
-#
-# The style and bibliography files are in ./Manual/. Nothing needs to
-# be done, since style files and bibliography files are prefixed
-# with the relative ./Manual/ path.
-#
-# - 2. Individual CGAL Packages + CGAL Package 'Manual'
-#
-# The style and bibliography files are in ../../Manual/doc_tex/Manual/.
-# The search paths get the ../../Manual/doc_tex/ path prepended.
-#
-# - 3. All other environments
-#
-# The style and bibliography files need to be installed properly
-# from the SVN package Manual, such that the tools can find them, for
-# example through the search paths defined in the environment variables
-# TEXINPUTS, BIBINPUTS, and LATEX_CONV_INPUTS. Recall that the style
-# and bibliography files are prefixed with './Manual/', so the
-# Manual subdirectory needs to be found in the search paths.
-#
-# This script properly adds entries in TEXINPUTS, BIBINPUTS, and
-# LATEX_CONV_INPUTS so that bib and style files are found. It also
-# adds ../examples:../demo to access the example source codes.
-#
-#
-# When the -testsuite option is used the script will copy all the manuals
-# and logfiles to $TestSuiteResultPath/CGAL-$CgalVersion/ and creates an
-# HTML summary page index.html in that subdirectory. The latest result
-# is also always accessible at $TestSuiteResultPath/LAST/index.html .
-# Futhermore, the script will cleanup old results. For the most recent
-# number $TestSuiteFullHistory of test suites the full results including
-# the manuals are kept. Older test suites will have their manuals deleted
-# to save space. In total only $TestSuiteHistory many test suites are kept.
-# The history of test suites is managed in a shift-register like fashion
-# using files in $TestSuiteResultPath of defined names History. that
-# contain the name of the i-th test suite subdirectory. The 1st is the
-# most recent test suite and corresponds to the 'last' directory.
-# If the test suite is repeated for the same internal release number,
-# the new results will overwrite the old results.
-# ============================================================================
-
-shopt -s nullglob
-
-# =====================================================================
-# Begin of Configuration Section: ...
-# =====================================================================
-
-Latex="latex"
-# idea, not finished: if $Latex --help | grep file-line-error-style
-PdfLatex="pdflatex"
-Bibtex="bibtex -terse"
-MakeIndex="makeindex -q"
-IndexFix="index_fix"
-Sort="sort"
-DvipsA4="dvips -q -D 600 -t a4 -P pdf -G0"
-Gzip="gzip"
-GnuTar="tar"
-LatexToHtml="latex_to_html"
-Sendmail=mail
-
-ResourceFile="$HOME/.cgalmanualrc"
-
-HtmlManualAuthor='CGAL Open Source Project'
-
-#---------------------------------------------------------------------#
-# Global variables, default initialization
-#---------------------------------------------------------------------#
-
-# Selects the different output formats supported
-MakePS=0
-MakePDF=1
-MakeHTML=1
-
-# Run Linklint
-TestLinkLint=0
-
-# Selects that only the LaTeX wrapper files for packages are created
-MakeWrapperOnly=0
-
-# Selects if the results are collected and formatted for the test-suite
-# result pages on the web and copies them there
-MakeTestSuiteResult=0
-
-# For the test-suite, the C++ headers are supposed to be at a canonical
-# place, such that if the HTML manuals are installed in the canonical
-# /doc_html location, the linking from \ccInclude statements works.
-TestSuiteCppHeader="../../include"
-
-# Number of lines in the result table before an intermediate table header
-# is written for better overview.
-TestSuiteTableHeightMax=12
-
-# Counter counting the lines written the testsuite result tables
-TestSuiteTableHeight=0
-
-# The corresponding address in the file space for copying the
-# test-suite result pages. Needs to be in the file system, because
-# not only are pages copied, but the script manages also a clever
-# history of up to $TestSuiteHistory many test-suite results and
-# deletes older ones.
-TestSuiteResultPath="/var/CGAL/www/Members/Manual_test"
-
-# Number of older test-suite results kept. Test-suite results beyond this
-# number are deleted.
-TestSuiteHistory=8
-
-# Number of older test-suites for which the full results will be kept. Older
-# test suites will have their manuals removed to save space.
-TestSuiteFullHistory=3
-
-# Email address to send the end-of-testsuite announcement to. If this
-# variable is empty, no email will be send.
-TestSuiteResultEmail=""
-
-# The url prefix of the result web page
-TestSuiteResultUrl="https://cgal.geometryfactory.com/CGAL/Members/Manual_test"
-
-# =====================================================================
-# ... End of Configuration Section.
-# =====================================================================
-
-# Determines if we currently make a Module or Package manual.
-# Only one is set to 1.
-MakeModule=0
-MakePackage=0
-
-# Name of this script, without leading path
-ProgName=${0##*/}
-
-# We keep some statistics for the protocol
-TotalStartTime=$SECONDS
-Date="`LC_TIME="POSIX" date '+%d %b %Y'`"
-Time="`date '+%T %Z'`"
-
-# Try to determine the CGAL version (works only for internal/external releases)
-# Otherwise use date.
-if [ -r version.tex ]; then
- CgalVersion="`cat version.tex | grep '\\cgalversion[{]' | sed 's/[}]$//' | sed 's/.*[{]//'`"
- CgalInternalVersion="`cat version.tex | grep '\\cgalinternalversion[{]' | sed 's/[}]$//' | sed 's/.*[{]//'`"
- CgalVersionHtml="Release ${CgalVersion}"
- CgalVersionDate="`cat version.tex | grep '\\cgalversiondate[{]' | sed 's/[}]$//' | sed 's/.*[{]//'`"
-else
- CgalVersion=`echo ${Date} | sed 's/ /_/g'`
- CgalInternalVersion=$CgalVersion
- CgalVersionHtml="Separate Build"
- CgalVersionDate="`LC_TIME="POSIX" date '+%e %B %Y'`"
-fi
-
-# Selects no console output except error messages
-Quiet=0
-
-# Selects no console output at all, not even error messages
-RealQuiet=0
-
-# Selects detailed console output, includes the logfile output
-Verbose=0
-
-# By default, the log file will be deleted at the end if there were no errors.
-# With $KeepLog one can keep the log in any case. With $NoLog it will
-# be deleted in any case.
-KeepLog=0
-NoLog=0
-
-# Selects to keep the summary lines of the console output also in a sumary file
-Sum=0
-
-# Read the resource file
-ReturnStatus=0
-if [ -r "$ResourceFile" ] ; then
- source "$ResourceFile"
-fi
-if [ $ReturnStatus -ne 0 ] ; then
- exit $ReturnStatus
-fi
-
-# Color changing control sequences. Makes protocols more readable.
-# There is a translation to HTML format in the corresponding code below.
-BlueColor=""
-BoldColor=""
-OkColor=""
-ErrorColor=""
-WarnColor=""
-ResetColor=""
-if [ -t 2 ] ; then # is stderr connected to a terminal
- case "$TERM" in
- xterm* | vt100* | console* ) # terminals believed to have color capability
- BlueColor='[1m[34m' # blue boldface
- BoldColor='[1m' # boldface
- OkColor='[32m' # green
- ErrorColor='[1m[31m' # red boldface
- WarnColor='[35m' # magenta
- ResetColor='[30m[00m' # black, reset attribute
- ;;
- esac
-fi
-
-cmd_log="cmd_log"
-rm -f $cmd_log
-
-# search and replace
-
-#if [ "$#" != "4" ] ; then
-# echo "usage: $0 path filenamepattern stringtofind replacement"
-# exit 1
-#fi
-#
-#echo "looking for files named \"$2\" in dir \"$1\", replacing $3 with $4"
-
-search_and_replace() {
- find $1 -type f -name "$2" | while read f ; do
- sed "s/$3/$4/g" < $f > $f.tmp && mv $f.tmp $f
- done
-}
-
-
-#---------------------------------------------------------------------#
-# version
-#---------------------------------------------------------------------#
-
-version_no() {
- echo '$Id$' | sed 's/[$]Revision: //' | sed 's/ [$]//g'
-}
-
-version_date() {
- echo '$Date$' | sed 's/[$]Date: //' | \
- sed 's/ [0-9][0-9]:[0-9][0-9]:[0-9][0-9] [$]//'
-}
-
-version() {
- echo "${BoldColor}${ProgName}:${ResetColor} ${BlueColor}Revision `version_no` [`version_date`]"\
- " (c) Lutz Kettner${ResetColor}" 1>&2
-}
-
-#---------------------------------------------------------------------#
-# usage
-#---------------------------------------------------------------------#
-
-usage() {
- version
- cat 1>&2 <] [] []${ResetColor}
- Creates CGAL manuals from CGAL packages or modules. It should be called in
- the ./doc_tex/ directory of a CGAL internal release or SVN checkout.
- ${BoldColor}CGAL packages${ResetColor} are given as a subdirectory that contains a main.tex file;
- a wrapper file that includes main.tex is automatically generated and
- deleted at the end. Use -wrapper to create a wrapper file permanently.
- ${BoldColor}CGAL modules${ResetColor} are given as an explict LaTeX file, e.g., generated with
- -wrappe.r
- The results are the specified manuals in the corresponding ../doc_ps,
- ../doc_pdf, and ../doc_html directories. A logfile .cgallog is created
- with a logfile summary from the individual logfiles .log, .blg, .ilg, .plg,
- and .hlg. The logfiles are kept in case of warnings and error messages.
- The screen output reports the progress and result status of each
- module (abbrev. as Mod) and package (abbrev. as Pck) and each manual type.
-${BoldColor}Options:${ResetColor}
- ${BoldColor}-ps${ResetColor} PostScript manuals.
- ${BoldColor}-pdf${ResetColor} PDF manuals.
- ${BoldColor}-html${ResetColor} HTML manuals (incl. a LaTeX run).
- ${BoldColor}-wrapper${ResetColor} creates the LaTeX wrapper files only.
- ${BoldColor}-testsuite${ResetColor} runs testsuite, installs results and sends email. Use
- only after reading the config section of this script.
- Implies -sub-modules=all
- ${BoldColor}-nopublish${ResetColor} do not publish results after running the testsuite
- ${BoldColor}-h${ResetColor} help (this text).
- ${BoldColor}-V${ResetColor} version.
- ${BoldColor}-v${ResetColor} verbose: repeats logfiles on stderr.
- ${BoldColor}-k${ResetColor} keep logfiles (default: delete after a clean run).
- ${BoldColor}-n${ResetColor} no logfile: delete logfiles always.
- ${BoldColor}-s${ResetColor} create a summary logfile .sum .
- ${BoldColor}-quiet${ResetColor} no progress messages.
- ${BoldColor}-realquiet${ResetColor} suppresses also error messages.
- ${BoldColor}-cmdlog${ResetColor} create a logfile "cmd_log" containing all commands
- that were issued during execution
-
- ${BoldColor}-sub-modules=mod1,mod2...${ResetColor}
- build specified sub-modules, given as a comma-
- separated list. A special one is ${BoldColor}all${ResetColor}, which matches
- all sub-modules present in the current directory.
-
-
- For example, if there is a module "mod" with its
- sub-module file "mod__submodule.only.tex", only the
- "submodule" part has to be specified.
-EOF
-}
-
-
-#---------------------------------------------------------------------#
-# summary ....
-# - writes ' ...' in a single line to stdout and the $LogFile
-# - if is '-n' then the line break is suppressed.
-# - if $Quiet is set the output to stdout gets suppressed
-# - We keep an (accumulated) copy of all output done with -n.
-# We use that in the error() function if the -q (quiet) switch
-# was used to actually print what was not printed so far.
-#---------------------------------------------------------------------#
-
-NBuffer=""
-
-update_nbuffer() {
- if [ "$1" == "-n" ] ; then
- shift
- NBuffer="$NBuffer""$*"
- else
- NBuffer=""
- fi
-}
-
-pad_nbuffer() {
- # output '. . . . ' pattern up to column $1 taking NBuffer into account
- # make length even first
- declare -i len=$1-${#NBuffer}
- declare -i even="$len%2"
- if [ $even -ne 0 ] ; then
- echo -n " "
- len=$len-1
- fi
- while [ $len -gt 0 ] ;
- do
- echo -n ". "
- len=$len-2
- done
-}
-
-summary() {
- update_nbuffer "$@"
- if [ $Verbose -eq 0 ] ; then
- if [ $Quiet -eq 0 ] ; then
- echo "$@"
- fi
- fi
- echo "$@" | sed 's/[[][^m]*m//g;' >> $LogFile
-}
-
-#---------------------------------------------------------------------#
-# error ....
-# - writes ' ...' in a single line to stdout and the $LogFile
-# - if is '-n' then the line break is suppressed
-# - if $RealQuiet is set the output to stdout gets suppressed
-# - works together with summary to not loose stuff from NBuffer
-# where output used the -n flag.
-#---------------------------------------------------------------------#
-
-error() {
- if [ $RealQuiet -eq 0 ] ; then
- if [ $Verbose -eq 0 ] ; then
- if [ $Quiet -eq 1 ] ; then
- echo -n "$NBuffer"
- fi
- echo "$@"
- fi
- fi
- echo "$@" | sed 's/[[][^m]*m//g;' >> $LogFile
- NBuffer=""
-}
-
-#---------------------------------------------------------------------#
-# cmdlog ....
-# append commandline to command logfile
-# evaluate commandline
-# if -noexec is given as first argument, do not execute. just output
-#---------------------------------------------------------------------#
-
-cmdlog() {
- local do_exec=1;
- if [ "$1" == "-noexec" ] ; then
- do_exec=0;
- shift;
- fi
- if [ $DoCmdLog -eq 1 ]; then
- printf "%s\n" "$@" >> $cmd_log
- fi
- if [ $do_exec -eq 1 ]; then
- eval "$@";
- fi
-}
-
-
-#---------------------------------------------------------------------#
-# log ....
-# - writes ' ...' in a single line to the $TmpLogFile
-# - if is '-n' then the line break is suppressed
-# - if $Verbose is set it echos the output also to stdout
-#---------------------------------------------------------------------#
-
-log() {
- if [ $Verbose -eq 1 ] ; then
- echo "$@"
- fi
- echo "$@" >> $TmpLogFile
-}
-
-#---------------------------------------------------------------------#
-# log_divider
-# - writes '--------------- ---' to log file
-# - formatted to 78 columns
-#---------------------------------------------------------------------#
-
-log_divider() {
- Pad=""
- Aux="$*"
- declare -i len=51-${#Aux}
- while [ $len -gt 0 ] ;
- do
- Pad="-$Pad"
- len=$len-1
- done
- log "------------------------- $* $Pad"
-}
-
-#---------------------------------------------------------------------#
-# print_time
-# - and are in seconds
-# - format printed is hh:mm:ss
-#---------------------------------------------------------------------#
-
-print_time() {
- declare -i DiffTime=$2-$1
- declare -i Hours="$DiffTime/3600"
- declare -i Minutes="($DiffTime/60)%60"
- declare -i Seconds="$DiffTime%60"
- printf "%02d:%02d:%02d" $Hours $Minutes $Seconds
-}
-
-#---------------------------------------------------------------------#
-# is_in_list
-# - Returns 0 if is contained in and 1 otherwise
-#---------------------------------------------------------------------#
-
-is_in_list() {
- N=$1
- shift
- for f in $@ ; do
- if [[ $N == $f ]]; then return 0; fi
- done
- return 1
-}
-
-#---------------------------------------------------------------------#
-# find_in_search_path
-# - searches for in all directories listed in the
-# colon separated starting at ${CurrentDir}
-# - Echos the first path that contains , otherwise nothing.
-#---------------------------------------------------------------------#
-
-find_in_search_path() {
- search_paths="`echo $2 | sed 's/:/ /g'`"
- for p in ${search_paths} ; do
- if [[ "$p" != "" && -r ${CurrentDir}/$p/$1 ]]; then
- echo -n $p
- return
- fi
- done
-}
-
-#---------------------------------------------------------------------#
-# create_wrapper []
-# - Writes LaTeX wrapper file .tex for CGAL package
-# - CGAL package has name , an optional second argument
-# gives the name of a reference manual part put side-by-side
-# in the table of contents.
-#---------------------------------------------------------------------#
-
-create_wrapper() {
- QName="`echo $1 | sed 's/_/\\\\_/g'`"
- cat <
-# - Removes all temporaries, called after LaTeX and PDFLaTeX
-#---------------------------------------------------------------------#
-
-cleanup_latex() {
- rm -f $1.toc $1.bmt $1.mtc* $1.idx $1.ind $1.dvi $1.inc $1.out $1.ref
- rm -f $1.ind.unfixed
- find . -name "listofrefpages.tex" | while read f ; do cmdlog "rm $f"; done
- if [ $MakeHTML -eq 0 ]; then
- rm -f $1.aux $1.bbl
- fi
- # in case the log was not asked for, delete it
- if [[ $NoLog -eq 1 || ( $KeepLog -eq 0 &&
- ( $RetCode -eq 0 || $RetCode -eq 5 )) ]] ; then
- rm -f $1.log $1.blg $1.ilg
- fi
- return
-}
-
-#---------------------------------------------------------------------#
-# check_latex_warn
-# - Checks if latex logfile contains valid warnings
-# - Returns 0 if there are valid warnings, 1 otherwise
-#---------------------------------------------------------------------#
-
-check_latex_warn() {
- if [ $MakePackage -eq 0 ]; then
- if egrep -v "((Rerun to get cross-references right)|(warning[$]))" \
- $1.log | grep -i warn > /dev/null ; then
- return 0
- fi
- else # for CGAL Packages, also ignore warnings of undef. references
- if egrep -v "((Rerun to get cross-references right)|(warning[$])|(LaTeX Warning: Reference)|(undefined references))" $1.log | grep -i warn > /dev/null ; then
- return 0
- fi
- fi
- return 1
-}
-
-#---------------------------------------------------------------------#
-# check_bibtex_warn
-# - Checks if bibtex logfile contains valid warnings
-# - Returns 0 if there are valid warnings, 1 otherwise
-#---------------------------------------------------------------------#
-
-check_bibtex_warn() {
- if grep -v "warning[$]" $1.blg | grep -i warn > /dev/null ; then
- return 0
- fi
- return 1
-}
-
-#---------------------------------------------------------------------#
-# check_bibtex_empty
-# - Checks if bibtex logfile contains the empty bibliography
-# error message and no other error message.
-# - Returns 0 if there are valid warnings, 1 otherwise
-#---------------------------------------------------------------------#
-
-check_bibtex_empty() {
- if grep 'I found no \\citation commands' $1.blg > /dev/null ; then
- if grep 'There was 1 error message' $1.blg > /dev/null ; then
- return 0
- fi
- fi
- return 1
-}
-
-#---------------------------------------------------------------------#
-# check_index_warn
-# - Checks if makeindex logfile contains valid warnings
-# - Returns 0 if there are valid warnings, 1 otherwise
-#---------------------------------------------------------------------#
-
-check_index_warn() {
- if grep -v "lines written, 0 warnings" $1.ilg \
- | grep -i warn > /dev/null ; then
- return 0
- fi
- return 1
-}
-
-#---------------------------------------------------------------------#
-# testsuite_entry
-# - writes a single
cell in HTML report table to stdout
-# - reports exit-code results: 0 = ok, 1 = error, 2 = warning, 3 = n.a.
-#---------------------------------------------------------------------#
-
-SP=" "
-
-testsuite_entry() {
- if [ $1 -eq 0 ]; then
- echo "
"
- fi
-}
-
-
-#---------------------------------------------------------------------#
-# sort_ref_pages
-# - Sorts the reference pages in $1.ref if they exist
-#---------------------------------------------------------------------#
-
-sort_ref_pages() {
- find . -name "listofrefpages.tex" | while read f ; do
- cmdlog "${Sort} -f $f > $f.sorted" # +2 -3 what was this used for?
- cmdlog "mv $f.sorted $f"
- done
-}
-
-#---------------------------------------------------------------------#
-# report_latex
-# - Reports summary of error messages and warnings from LaTeX, BibTeX,
-# and makeindex log files.
-#---------------------------------------------------------------------#
-
-report_latex() {
- echo ""
- echo "Summary LaTeX"
- echo "-------------"
- echo "For the full logfile see $1.log"
- if [ $MakePackage -eq 1 ]; then
- echo "Since this is a CGAL Package manual, one can probably ignore "
- echo "warnings about undefined references or missing header files."
- fi
- egrep -i '((error)|(^[!]))' $1.log | grep -v "operatorerror"
- grep -i warn $1.log
- if [ $MakeTestSuiteResult -eq 1 ]; then mv $1.log testsuite/$1.log.txt ; fi
- if [ -r $1.blg ]; then
- echo ""
- echo "Summary BibTeX"
- echo "--------------"
- echo "For the full logfile see $1.blg"
- grep -i error $1.blg
- grep 'I found no \\citation commands' $1.blg
- grep -i warn $1.blg | grep -v 'warning[$]'
- if [ $MakeTestSuiteResult -eq 1 ]; then
- mv $1.blg testsuite/$1.blg.txt
- fi
- fi
- if [ -r $1.ilg ]; then
- echo ""
- echo "Summary makeindex"
- echo "-----------------"
- echo "For the full logfile see $1.ilg"
- egrep -i '((error)|(reject))' $1.ilg
- grep -i warn $1.ilg
- if [ $MakeTestSuiteResult -eq 1 ]; then
- mv $1.ilg testsuite/$1.ilg.txt
- fi
- fi
- echo ""
- return
-}
-
-
-#---------------------------------------------------------------------#
-# run_latex
-# - Runs LaTeX, either brief for HTML, or full for stable PS
-# - Includes BiBTeX and makeindex if needed.
-# - Returns in $RetCode: 1 = error, 2 = warning, 5 = expected warning
-# - Prints logfile summary result in stdout
-#---------------------------------------------------------------------#
-
-run_latex() {
- # codes memorized for the different passes:
- # 0 = ok, 1 = error, 2 = warning, 3 = n.a.
- LatexExit=0
- BibtexExit=4
- IndexExit=4
- RetCode=0 # total return code
- # first run
-
- if ! cmdlog "$Latex --interaction batchmode $1" ; then LatexExit=1 ; fi
- sort_ref_pages $1
- # see if we need BiBTeX and run it
- if grep '[\\]bibdata' $1.aux > /dev/null ; then
- if cmdlog "$Bibtex $1" ; then BibtexExit=0 ; else BibtexExit=1 ; fi
- # Check for documents that have a bibliography entry,
- # but no citations. Don't create an empty bibliograpy then.
- if check_bibtex_empty $1 ; then
- cmdlog "rm -f $1.bbl"
- BibtexExit=0
- else
- # Run LaTeX to get citations into the auxfile.
- if ! cmdlog "$Latex --interaction batchmode $1"; then LatexExit=1 ; fi
- sort_ref_pages $1
- fi
- fi
- # see if we need full LaTeX results, or if suffices what we have so far
- if [ ${MakePS} -eq 1 ] ; then
- # Make sure that there is at least one rerun if makeindex is requested
- if [ -r $1.idx ]; then
- IndexExit=1
- if cmdlog "${MakeIndex} $1.idx"; then
- if cmdlog "${IndexFix} $1.ind"; then IndexExit=0; fi
- fi
- if ! cmdlog "$Latex --interaction batchmode $1"; then LatexExit=1 ; fi
- sort_ref_pages $1
- fi
- # Run LaTeX until their is no rerun necessary anymore + one more
- # but at most 5 times (prevent infinite loop, as happened for Straight_skeleton)
- declare -i LastRerun=5
- while [ $LastRerun -gt 1 ]; do
- if grep "Rerun to get cross-references right" $1.log > /dev/null; then
- LastRerun=$LastRerun-1;
- else LastRerun=0; fi
- # Run makeindex as well if requested
- if [ -r $1.idx ]; then
- IndexExit=1
- if cmdlog "${MakeIndex} $1.idx"; then
- if cmdlog "${IndexFix} $1.ind"; then IndexExit=0; fi
- fi
- fi
- if ! cmdlog "$Latex --interaction batchmode $1"; then LatexExit=1 ; fi
- sort_ref_pages $1
- done
- if [ -r $1.dvi ]; then
- if ! cmdlog "${DvipsA4} $1 -o $1.ps" ; then RetCode=1; fi
- fi
- if [ -r $1.ps ]; then
- if ! cmdlog "${Gzip} $1.ps" ; then RetCode=1; fi
- fi
- if [ $MakeTestSuiteResult -eq 1 ]; then
- mv $1.ps.gz testsuite
- else
- if [ ! -d ../doc_ps ]; then mkdir ../doc_ps; fi
- if [ ! -d ../doc_ps ]; then
- echo "ERROR: Something is wrong, I cannot create directory '../doc_ps' ."
- RetCode=1
- else
- mv $1.ps.gz ../doc_ps
- fi
- fi
- fi
- # check for include files that don't exist
- if [ -r $1.inc ]; then
- for f in `cat $1.inc | sort | uniq` ; do
- if [ ! -r ../include/$f ]; then
- echo "WARNING: Include file '$f' does not exist!" >> $1.log
- if [ ! $LatexExit -eq 1 ]; then LatexExit=2; fi
- fi
- done
- fi
- if [ $LatexExit -eq 0 ]; then
- if check_latex_warn $1 ; then LatexExit=2; fi
- fi
- if [ $IndexExit -eq 0 ]; then
- if check_index_warn $1 ; then IndexExit=2; fi
- fi
- if [ $BibtexExit -eq 0 ]; then
- if check_bibtex_warn $1 ; then BibtexExit=2; fi
- fi
- if [ $MakeTestSuiteResult -eq 1 ]; then
- if [ $MakePS -eq 1 ]; then
- testsuite_entry $LatexExit $1.log.txt > testsuite/index_row
- fi
- testsuite_entry $BibtexExit $1.blg.txt >> testsuite/index_row
- testsuite_entry $IndexExit $1.ilg.txt >> testsuite/index_row
- if [ ${MakePDF} -eq 0 ] ; then
- # one empty entry for PdfLaTeX run
- testsuite_entry 4 $1.pdflg.txt >> testsuite/index_row
- fi
- fi
- if [ $RetCode -eq 0 ] ; then
- if [[ $LatexExit -eq 1 || $BibtexExit -eq 1 || $IndexExit -eq 1 ]]; then
- RetCode=1
- fi
- fi
- if [ $RetCode -eq 0 ] ; then
- if [[ $LatexExit -eq 2 || $BibtexExit -eq 2 || $IndexExit -eq 2 ]]; then
- RetCode=2
- fi
- fi
- # Special handling if LaTeX is only needed as preparation for the
- # HTML manual, since we see 'undefined...' messages that we can ignore.
- if [[ ${MakePS} -eq 0 && $LatexExit -eq 2 ]]; then
- LatexExit=5
- if [ $RetCode -eq 2 ] ; then
- RetCode=5
- fi
- fi
- report_latex $1
- if [ ${MakePDF} -eq 0 ] ; then
- cleanup_latex $1
- else
- rm -f $1.aux $1.toc $1.bmt $1.mtc*
- fi
- return $RetCode
-}
-
-#---------------------------------------------------------------------#
-# report_pdflatex
-# - Reports summary of error messages and warnings from LaTeX
-# and makeindex log files.
-#---------------------------------------------------------------------#
-
-report_pdflatex() {
- echo ""
- echo "Summary PdfLaTeX"
- echo "----------------"
- echo "For the full logfile see $1.pdflg"
- if [ $MakePackage -eq 1 ]; then
- echo "Since this is a CGAL Package manual, one can probably ignore "
- echo "warnings about undefined references."
- fi
- egrep -i '((error)|(^[!]))' $1.log | grep -v "operatorerror"
- grep -i warn $1.log
- if [ $MakeTestSuiteResult -eq 1 ]; then mv $1.log testsuite/$1.pdflg.txt ; fi
- if [[ ${MakePS} -eq 0 && -r $1.blg ]]; then
- echo ""
- echo "Summary BibTeX"
- echo "--------------"
- echo "For the full logfile see $1.blg"
- grep -i error $1.blg
- grep 'I found no \\citation commands' $1.blg
- grep -i warn $1.blg | grep -v 'warning[$]'
- if [ $MakeTestSuiteResult -eq 1 ]; then
- mv $1.blg testsuite/$1.blg.txt
- fi
- fi
- if [ -r $1.ilg ]; then
- echo ""
- echo "Summary makeindex"
- echo "-----------------"
- if [ ${MakePS} -eq 0 ]; then
- echo "For the full logfile see $1.ilg"
- egrep -i '((error)|(reject))' $1.ilg
- grep -i warn $1.ilg
- if [ $MakeTestSuiteResult -eq 1 ]; then
- mv $1.ilg testsuite/$1.ilg.txt
- fi
- else
- echo "For the full logfile see $1.ilg from the regular LaTeX run"
- egrep -i '((error)|(reject))' $1.ilg
- grep -i warn $1.ilg
- fi
- fi
- echo ""
- return
-}
-
-#---------------------------------------------------------------------#
-# run_pdflatex
-# - Runs PdfLaTeX for stable PDF
-# - Includes makeindex if needed.
-# - BiBTeX was already done (if necessary) in run_latex
-# - Returns in $RetCode: 1 = error, 2 = warning
-# - Prints logfile summary result in stdout
-# - The LaTeX logfile *.log from the previous run_latex run
-# has been saved temporarily by the calling function
-#---------------------------------------------------------------------#
-
-run_pdflatex() {
- # codes memorized for the different passes:
- # 0 = ok, 1 = error, 2 = warning, 3 = n.a.
- LatexExit=0
- BibtexExit=4
- IndexExit=4
- RetCode=0 # total return code
- # first run
-
- if ! cmdlog "$PdfLatex --interaction batchmode $1"; then LatexExit=1 ; fi
- sort_ref_pages $1
- # see if we need BiBTeX and run it
- if [ ${MakePS} -eq 0 ] ; then
- if grep '[\\]bibdata' $1.aux > /dev/null ; then
- if cmdlog "$Bibtex $1" ; then BibtexExit=0 ; else BibtexExit=1 ; fi
- # Check for documents that have a bibliography entry,
- # but no citations. Don't create an empty bibliography then.
- if check_bibtex_empty $1 ; then
- rm -f $1.bbl
- BibtexExit=0
- else
- # Run LaTeX to get citations into the auxfile.
- cmdlog "$PdfLatex --interaction batchmode $1"
- if [ $? -ne 0 ]; then LatexExit=1 ; fi
- sort_ref_pages $1
- fi
- fi
- fi
- # Make sure that there is at least one rerun if makeindex is requested
- if [ -r $1.idx ]; then
- IndexExit=1
- if cmdlog "${MakeIndex} $1.idx" ; then
- if cmdlog "${IndexFix} $1.ind" ; then IndexExit=0; fi
- fi
- cmdlog "$PdfLatex --interaction batchmode $1"
- if [ $? -ne 0 ]; then LatexExit=1 ; fi
- sort_ref_pages $1
- fi
- # Run LaTeX until their is no rerun necessary anymore + one more
- declare -i LastRerun=5
- while [ $LastRerun -gt 1 ]; do
- if grep "Rerun to get cross-references right" $1.log > /dev/null; then
- LastRerun=$LastRerun-1;
- else LastRerun=0; fi
- # Run makeindex as well if requested
- if [ -r $1.idx ]; then
- IndexExit=1
- if cmdlog "${MakeIndex} $1.idx" ; then
- if cmdlog "${IndexFix} $1.ind" ; then IndexExit=0; fi
- fi
- fi
- cmdlog "$PdfLatex --interaction batchmode $1"
- if [ $? -ne 0 ]; then LatexExit=1 ; fi
- sort_ref_pages $1
- done
- if [ $MakeTestSuiteResult -eq 1 ]; then
- mv $1.pdf testsuite
- else
- if [ ! -d ../doc_pdf ]; then mkdir ../doc_pdf; fi
- if [ ! -d ../doc_pdf ]; then
- echo "ERROR: Something is wrong, I cannot create directory '../doc_pdf' ."
- RetCode=1
- else
- mv $1.pdf ../doc_pdf
- fi
- fi
- if [ $LatexExit -eq 0 ]; then
- if check_latex_warn $1 ; then LatexExit=2; fi
- fi
- if [ $BibtexExit -eq 0 ]; then
- if check_bibtex_warn $1 ; then BibtexExit=2; fi
- fi
- if [ $IndexExit -eq 0 ]; then
- if check_index_warn $1 ; then IndexExit=2; fi
- fi
- if [ $MakeTestSuiteResult -eq 1 ]; then
- # Report bibtex and index errors here only if regular LaTeX was not run
- if [ ${MakePS} -eq 0 ] ; then
- testsuite_entry $BibtexExit $1.blg.txt >> testsuite/index_row
- testsuite_entry $IndexExit $1.ilg.txt >> testsuite/index_row
- fi
- testsuite_entry $LatexExit $1.pdflg.txt >> testsuite/index_row
- fi
- if [ ${MakePS} -eq 1 ] ; then
- # do error and warn reporting restricted to PdfLaTeX
- if [ $RetCode -eq 0 ] ; then
- if [[ $LatexExit -eq 1 ]]; then
- RetCode=1
- fi
- fi
- if [ $RetCode -eq 0 ] ; then
- if [[ $LatexExit -eq 2 ]]; then
- RetCode=2
- fi
- fi
- else
- # do full error and warn reporting for PdfLaTeX, BibTeX, make_index
- if [ $RetCode -eq 0 ] ; then
- if [[ $LatexExit -eq 1 || $BibtexExit -eq 1 || $IndexExit -eq 1 ]]; then
- RetCode=1
- fi
- fi
- if [ $RetCode -eq 0 ] ; then
- if [[ $LatexExit -eq 2 || $BibtexExit -eq 2 || $IndexExit -eq 2 ]]; then
- RetCode=2
- fi
- fi
- fi
- report_pdflatex $1
- cleanup_latex $1
- return $RetCode
-}
-
-#---------------------------------------------------------------------#
-# report_html
-# - Reports summary of error messages and warnings from HTML conversion
-#---------------------------------------------------------------------#
-
-report_html() {
- echo ""
- echo "Summary LaTeX_to_HTML"
- echo "---------------------"
- echo "For the full logfile see $1.hlg"
- grep -i error $1.hlg
- grep -i rejected $1.hlg
- grep -i warn $1.hlg
- echo ""
- return
-}
-
-#---------------------------------------------------------------------#
-# cleanup_html
-# - Removes all temporaries
-#---------------------------------------------------------------------#
-
-cleanup_html() {
- rm -f $1.ref $1.aux $1.bbl
- # in case the log was not asked for, delete it
- if [[ $NoLog -eq 1 || ( $KeepLog -eq 0 && $RetCode -eq 0 ) ]] ; then
- rm -f $1.hlg
- fi
- return
-}
-
-#---------------------------------------------------------------------#
-# run_html
-# - Runs LaTeX_to_HTML
-# - Returns in $RetCode: 1 = error, 2 = warning
-# - Prints logfile summary result in stdout
-#---------------------------------------------------------------------#
-
-run_html() {
- RetCode=0
- ${LatexToHtml} -nocolor -V # lists only the version number for the summary
- # first run
- if [ $TestLinkLint -eq 1 -o $MakeTestSuiteResult -eq 1 ]; then
- cmdlog -noexec "${LatexToHtml} -quiet -date \"${CgalVersionDate}\" -release \"${CgalVersionHtml}\" -author \"$HtmlManualAuthor\" -o testsuite/$1 -header \"$TestSuiteCppHeader\" $1"
- ${LatexToHtml} -quiet -date "${CgalVersionDate}" -release "${CgalVersionHtml}" -author "$HtmlManualAuthor" -o testsuite/$1 -header "$TestSuiteCppHeader" $1
- if [ $? -ne 0 ]; then RetCode=1; fi
- cd testsuite
- ${GnuTar} czf $1.tgz $1
- cd ..
- else
- cmdlog -noexec "${LatexToHtml} -quiet -date \"${CgalVersionDate}\" -release \"${CgalVersionHtml}\" -author \"$HtmlManualAuthor\" -o ../doc_html/$1 $1"
- ${LatexToHtml} -stacktrace -date "${CgalVersionDate}" -release "${CgalVersionHtml}" -author "$HtmlManualAuthor" -o ../doc_html/$1 $1
- if [ $? -ne 0 ]; then RetCode=1; fi
- fi
- if [ $RetCode -ne 0 ]; then
- report_html $1
- cleanup_html $1
- return $RetCode
- fi
- if [ $RetCode -eq 0 ] ; then
- if [ $MakePackage -eq 0 ]; then
- if grep -v 'lines written' $1.hlg | grep -i warn > /dev/null ; then RetCode=2; fi
- else # for CGAL Packages, also ignore warnings of undef. references
- if grep -v 'lines written' $1.hlg | egrep -v "[!][!] Warning: undefined label" | \
- grep -i warn > /dev/null ;
- then RetCode=2; fi
- fi
- fi
- report_html $1
- cleanup_html $1
- return $RetCode
-}
-
-#---------------------------------------------------------------------#
-# try_command
-# - executes command and logs output of stdout and stderr in $TmpLogFile
-# - includes execution timing in output
-# - if $Verbose is set, it also echos the output to stdout
-# - Return codes of are also returned and $ExitCode set
-# 1 = error, 2 = warning, 5 = expected warning in HTML preparation
-#---------------------------------------------------------------------#
-
-try_command() {
- ExitCode=0
- local StartTime=$SECONDS
- local Text="$1"
- shift
- summary -n "$Text "
- log_divider "start $Text"
- rm -f $TmpLogFile.2
- if [ $Verbose -eq 1 ] ; then
- {
- # I need to pass the exitcode through the pipe and set $ExitCode.
- # That does not work easily with a pipe and I just use a file instead.
- eval "$@" 2>&1
- echo $? > $TmpLogFile.3
- cat $TmpLogFile.3
- } | tee $TmpLogFile.2
- ExitCode=`cat $TmpLogFile.3`
- rm -f $TmpLogFile.3
- else
- eval "$@" > $TmpLogFile.2 2>&1
- ExitCode=$?
- fi
- local EndTime=$SECONDS
- cat $TmpLogFile.2 >> $TmpLogFile
- rm -f $TmpLogFile.2
- log_divider "end $Text"
-
- # padding up to column 54
- if [ $ExitCode -eq 1 ] ; then
- error "`pad_nbuffer 54`[${ErrorColor}ERROR${ResetColor}] time = `print_time $StartTime $EndTime`"
- elif [ $ExitCode -eq 2 ] ; then
- error "`pad_nbuffer 54`[${WarnColor}WARNG${ResetColor}] time = `print_time $StartTime $EndTime`"
- elif [ $ExitCode -eq 5 ] ; then
- error "`pad_nbuffer 54` [${OkColor}html${ResetColor}] time = `print_time $StartTime $EndTime`"
- else
- summary "`pad_nbuffer 54`. [${OkColor}ok${ResetColor}] time = `print_time $StartTime $EndTime`"
- fi
- return $ExitCode
-}
-
-
-#---------------------------------------------------------------------#
-# is_module
-# - returns 0 if is name of a CGAL Module, and 1 otherwise
-#---------------------------------------------------------------------#
-
-is_module () {
- if [ -r $1.tex ]; then return 0; fi
- if [ -d $1 ]; then return 1; fi
- return 0
-}
-
-null_function() {
- return 0
-}
-
-# not logged in cmd_log. would be information overflow
-strip_aux_files() {
- for f in `find . -name "*.aux"`; do
- cat $f | grep -v writefile > ${f}.tmp
- mv ${f}.tmp $f
- done
-}
-
-
-# callback functions for make_manual in the context of building a whole manual
-before_latex_whole_manual() {
- null_function
-}
-
-
-before_pdf_whole_manual() {
- local files=`find . -name "*.aux"`
- if [ "$files" != "" ]; then
- strip_aux_files
- $GnuTar czf $1-latexauxfiles.tgz $files
- cmdlog -noexec "$GnuTar czf $1-latexauxfiles.tgz \`find . -name \"*.aux\"\`"
- fi
-}
-
-before_html_whole_manual() {
- local files=`find . -name "*.aux"`
- if [ "$files" != "" ]; then
- strip_aux_files
- $GnuTar czf $1-pdfauxfiles.tgz $files
- cmdlog -noexec "$GnuTar czf $1-pdfauxfiles.tgz \`find . -name \"*.aux\"\`"
- fi
-}
-
-# callback functions for make_manual in the context of building only a sub-manual
-before_latex_sub_manual() {
- if [ -r $1-latexauxfiles.tgz ]; then
- $GnuTar xzf $1-latexauxfiles.tgz
- cmdlog -noexec "$GnuTar xzf $1-latexauxfiles.tgz"
- fi
-}
-
-before_pdf_sub_manual() {
- if [ -r $1-latexauxfiles.tgz ]; then
- $GnuTar xzf $1-pdfauxfiles.tgz
- cmdlog -noexec "$GnuTar xzf $1-pdfauxfiles.tgz"
- fi
-}
-
-before_html_sub_manual() {
- null_function
-}
-
-sub_module_should_be_built() {
- if [ "$SubModules" == "all" ]; then
- return 0;
- fi
- for v in $SubModules; do
- if [ "$1" == "$v" ]; then
- return 0
- fi
- done
- return 1
-}
-
-#---------------------------------------------------------------------#
-# make_module
-#---------------------------------------------------------------------#
-make_module() {
- cmdlog "rm -f cgal_include_only.tex"
- local name=${1%.tex}
- local submodules=`find . -maxdepth 1 -name "${name}__*.only.tex"`;
-
- # only store aux-files, if we are interested in it, later
- if [ "$submodules" == "" ]; then
- make_manual ${name}
- else
- make_manual_prime \
- before_latex_whole_manual \
- before_pdf_whole_manual \
- before_html_whole_manual ${name}
- fi
-
- # afterwards, the sub-modules are made.
- # find all *.only.tex files in the current directory that
- # start with $1 and have a trailing __*.only.tex
- for submodule in $submodules; do
- local v=${submodule%.only.tex}
- v=${v#*__}
- if sub_module_should_be_built $v; then
- cmdlog "cp $submodule cgal_include_only.tex"
- submodule=${submodule%.only.tex}
- cmdlog "cp ${name}.tex $submodule.tex"
-
- make_manual_prime \
- before_latex_sub_manual \
- before_pdf_sub_manual \
- before_html_sub_manual $submodule
- # the wrapper is just a clone of .tex. purpose: avoid naming conflicts.
- # can be safely removed
- cmdlog "rm -f $submodule.tex"
- fi
- done
- cleanup_latex ${name}
- rm -f `find . -name "*.aux"`
- rm -f ${name}-latexauxfiles.tgz ${name}-pdfauxfiles.tgz
-}
-
-
-#---------------------------------------------------------------------#
-# make_manual_prime
-# []
-# - Manages the logfiles
-# - Creates all selected output formats
-# - For packages with user and reference manual, the second optional
-# argument is used to give the reference manual directory.
-#---------------------------------------------------------------------#
-
-make_manual_prime() {
- ReturnStatus=0
- local BeforeLatex=$1; shift
- local BeforePDF=$1; shift
- local BeforeHTML=$1; shift
-
- if [ $MakeWrapperOnly -eq 1 ]; then
- if [ -r $1.tex ]; then
- echo "${ErrorColor}ERROR${ResetColor}: Wrapper file '$1.tex' exists already." 1>&2
- LastFailedWrapper=$1
- GlobalReturnStatus=1
- return 1
- fi
- # test for the case that a wrapper for Mod was created and now
- # a wrapper for Mod and Mod_ref is requested. Avoid creating
- # a wrapper Mod_ref.tex.
- if [ "$1" == "${LastFailedWrapper}_ref" ]; then
- return 1
- fi
- LastFailedWrapper=""
- create_wrapper $@ > $1.tex
- cmdlog -noexec "cgal_manual -wrapper $1"
- if [ ! -r $1.tex ]; then
- echo "${ErrorColor}ERROR${ResetColor}: Something went wrong creating '${1}.tex'." 1>&2
- GlobalReturnStatus=1
- return 1
- fi
- return 0;
- fi
-
-
- #---------------------------------------------------------------------#
- # decide between Module and Package
- local MakeName="Err"
- local MakeModule
- local MakePackage
- local WrapperName
-
- if is_module $1 ; then
- MakeName="Mod"
- MakeModule=1
- MakePackage=0
- if [ -r $1.tex ]; then
- WrapperName=$1.tex
- else
- WrapperName=$1
- fi
- elif [[ -d $1 && -r $1/main.tex ]]; then
- MakeName="Pck"
- MakeModule=0
- MakePackage=1
- WrapperName=$1.tex
- create_wrapper $@ > ${WrapperName}
- cmdlog -noexec "cgal_manual -wrapper $1"
- else
- echo "" 1>&2
- echo "${ErrorColor}ERROR${ResetColor}: '$1' is neither a CGAL Package nor Module." 1>&2
- echo "" 1>&2
- GlobalReturnStatus=1
- return 1
- fi
- # Fail safe check against unexpected problems (file system full etc.)
- if [ ! -r ${WrapperName} ]; then
- echo "" 1>&2
- echo "${ErrorColor}ERROR${ResetColor}: Something went wrong creating '${WrapperName}'." 1>&2
- echo "" 1>&2
- GlobalReturnStatus=1
- return 1
- fi
-
- #---------------------------------------------------------------------#
- # Prepare logfiles
- local WrapperRootName=${WrapperName%.*}
- local TestsuiteRootNameAlignment="left"
- if [ ${WrapperRootName} == ${WrapperRootName//__/} ]; then
- TestsuiteRootName=${WrapperRootName}
- else
- TestsuiteRootName=__${WrapperRootName#*__}
- TestsuiteRootNameAlignment="right"
- fi
-
- local LogFile=${WrapperRootName}.cgallog
- local TmpLogFile=$LogFile.tmp
- local TmpOutFile=$LogFile.cout
-
- rm -f $LogFile
- touch $LogFile
-
- #---------------------------------------------------------------------#
- # run LaTeX, either brief or full
- $BeforeLatex ${WrapperRootName%__*}
- if [ ${MakePS} -eq 1 ]; then
- try_command "${MakeName} ${WrapperRootName} LaTeX" run_latex ${WrapperRootName}
- if [ $ExitCode -ne 0 ] ; then ReturnStatus=$ExitCode; fi
- fi
-
- #---------------------------------------------------------------------#
- # run PDFLaTeX
- $BeforePDF ${WrapperRootName%__*}
- if [[ ${MakePDF} -eq 1 || ${MakeHTML} -eq 1 ]]; then
- if [[ -r ${WrapperRootName}.log ]] ; then
- mv ${WrapperRootName}.log ${WrapperRootName}.texlg
- fi
- try_command "${MakeName} ${WrapperRootName} PDF " run_pdflatex ${WrapperRootName}
- if [[ -r ${WrapperRootName}.log ]] ; then
- mv ${WrapperRootName}.log ${WrapperRootName}.pdflg
- fi
- if [[ -r ${WrapperRootName}.texlg ]] ; then
- mv ${WrapperRootName}.texlg ${WrapperRootName}.log
- fi
- if [[ $ExitCode -ne 0 && ${ReturnStatus} -ne 1 ]]; then
- ReturnStatus=$ExitCode ;
- fi
- fi
-
- #---------------------------------------------------------------------#
- # run LaTeX_to_HTML
- $BeforeHTML ${WrapperRootName%__*}
- local HtmlExit=3
- local LinklintExit=3
- local LinklintRemoteCheckExit=3
- if [ ${MakeHTML} -eq 1 ]; then
- try_command "${MakeName} ${WrapperRootName} HTML " run_html ${WrapperRootName}
- HtmlExit=$ExitCode
- if [[ $ExitCode -ne 0 && ${ReturnStatus} -ne 1 ]]; then
- ReturnStatus=$ExitCode ;
- fi
- if [ $TestLinkLint -eq 1 -o $MakeTestSuiteResult -eq 1 ]; then
- mv ${WrapperRootName}.hlg testsuite/${WrapperRootName}.hlg.txt
- if which linklint >& /dev/null ; then
- mkdir testsuite/${WrapperRootName}-linklintresults
- # linklint, Local Site Checking
- linklint -limit 5000 -doc testsuite/${WrapperRootName}-linklintresults -index contents.html -no_anchors -quiet -silent /testsuite/${WrapperRootName}/@
- # linklint, Remote URL Checking
- linklint -limit 5000 @@ -doc testsuite/${WrapperRootName}-linklintresults -quiet -silent
- #REPLACEPATH="`pwd | sed -e 's/[/]/\\\//g'`"
- search_and_replace testsuite/${WrapperRootName}-linklintresults/ "*.html" "file:\/\/.\+\/doc_tex\/testsuite\/" '..\/'
-
- if grep 'No errors,' testsuite/${WrapperRootName}-linklintresults/log.txt >& /dev/null; then
- LinklintExit=0
- if ! grep 'no warnings.' testsuite/${WrapperRootName}-linklintresults/log.txt >& /dev/null; then
- LinklintExit=2
- fi
- else
- LinklintExit=1
- fi
- if grep 'ERROR' testsuite/${WrapperRootName}-linklintresults/urlindex.html >& /dev/null; then
- LinklintRemoteCheckExit=1
- else
- if grep 'warn' testsuite/${WrapperRootName}-linklintresults/urlindex.html >& /dev/null; then
- LinklintRemoteCheckExit=2
- else
- LinklintRemoteCheckExit=0
- fi
- fi
- fi
- fi
- fi
- if [ $MakeTestSuiteResult -eq 1 ]; then
- testsuite_entry $HtmlExit ${WrapperRootName}.hlg.txt >> testsuite/index_row
- testsuite_entry $LinklintExit ${WrapperRootName}-linklintresults/index.html >> testsuite/index_row
- testsuite_entry $LinklintRemoteCheckExit ${WrapperRootName}-linklintresults/urlindex.html >> testsuite/index_row
- fi
-
- #---------------------------------------------------------------------#
- # remove wrapper file if it is a CGAL package
- if [ ${MakePackage} -eq 1 ]; then rm ${WrapperName}; fi
-
- #---------------------------------------------------------------------#
- # echo summary in verbose mode and provide summary file
- rm -f $SumFile
-
- if [[ $Verbose -eq 1 && -r $LogFile ]] ; then cat $LogFile; fi
-
- if [[ $Sum -eq 1 && -r $LogFile ]] ; then cat $LogFile > $SumFile; fi
-
- #---------------------------------------------------------------------#
- # collect logfile
-
- echo "" >> $LogFile
- if [ -r $TmpLogFile ] ; then
- cat $TmpLogFile >> $LogFile
- fi
- rm -f $TmpLogFile
- echo "==============================================================================" >> $LogFile
-
- mv $LogFile $TmpLogFile
- local TotalEndTime=$SECONDS
-
- echo "==============================================================================" > $LogFile
- echo "$0 $CommandLineArgs" >> $LogFile
- echo "Date: $Date, Time: $Time" >> $LogFile
- echo "Pwd : `pwd`" >> $LogFile
- echo "Time: `print_time $TotalStartTime $TotalEndTime` total runtime." >> $LogFile
- echo "" >> $LogFile
- cat $TmpLogFile >> $LogFile
- rm -f $TmpLogFile
-
- #---------------------------------------------------------------------#
- # report testsuite results
- if [ $MakeTestSuiteResult -eq 1 ]; then
- mv $LogFile testsuite/${LogFile}.txt
- testsuite_middle_header
- echo "
" >> testsuite/index.html
- echo "
${TestsuiteRootName}
" >> testsuite/index.html
- if [ $ReturnStatus -eq 2 ]; then
- echo "
Program Test-Suite: [All Releases]
-Older Manual Tests:
-EOF
- declare -i count=1
- declare -i lastcount=${TestSuiteHistory}
- if [ -d ${TestSuiteResultPath}/CGAL-${CgalInternalVersion} ]; then
- count=2
- lastcount=${lastcount}+1
- fi
- while [ $count -lt ${lastcount} ] ; do
- if [ -r ${TestSuiteResultPath}/History.${count} ]; then
- subdir=`cat ${TestSuiteResultPath}/History.${count}`
- echo " [${subdir#CGAL-}]"\
- >> testsuite/index.html
- fi
- count=$count+1
- done
- cat >> testsuite/index.html <
-
-
This page shows the results of creating the manuals for
-CGAL-${CgalInternalVersion}. Each Module and each CGAL Package is tested for
-problems with LaTeX, BibTeX, makeindex, PdfLaTeX, and latex_to_html
-conversions. The success of the conversions and the logfiles are
-accessible in the tables below. A 'y' means no blatant errors
-occurred, which may be loosely interpreted as 'success', a 'w' means
-there was a warning, a 'n' means 'failure', and a '-' means that this part
-was not applicable to this manual. A click on the letter
-gives the corresponding logfiles. The first column contains a
-summary logfile for a quick overview.
-
-
The tools are currently under development, please report all
-problems to cgal-develop.
-
-
-
Due to the separate testing of each package, some references in the
- LaTeX manual may remain unresolved by the individual package
- tests. Thus undefined references are not reported as 'w' for packages.
- Please check the log files, for example, the summary log file, for
- undefined references in packages yourself. For Modules, undefined
- references are reported as 'w'.
-
The detection of errors is not (yet) exact. Please check the
- log files even when a 'y' appears and suggests that everything is
- OK.
-
Suggestions for improving the summary are also welcome.
-
-
-
-
Module Manual Test-Suite for CGAL-${CgalInternalVersion}
-
-EOF
- if [ ! -d ${TestSuiteResultPath} ]; then
- echo "${ErrorColor}ERROR${ResetColor}: The directory '${TestSuiteResultPath}' for the testsuite results does not exist." 1>&2
- GlobalReturnStatus=1
- else
- if [ $DoPublishTestsuiteResults -eq 1 ] ; then
- # When the -testsuite option is used the script will copy all
- # the manuals and logfiles to
- # $TestSuiteResultPath/CGAL-$CgalInternalVersion/ and creates an HTML
- # summary page index.html in that subdirectory. The latest
- # results is also always accessible at
- # $TestSuiteResultPath/last/index.html .
- # Futhermore, the script will cleanup old results. For the
- # most recent number $TestSuiteFullHistory of test suites the
- # full results including the manuals are kept. Older test
- # suites will have their manuals deleted to save space. Int
- # total only $TestSuiteHistory many test suites are kept.
- # The history of test suites is managed in a shift register
- # like fashion using files in $TestSuiteResultPath of defined
- # names History. that contain the name of the i-th test
- # suite subdirectory. The 1st is the most recent test suite
- # and corresponds to the 'last' directory.
- # If the test suite is repeated for the same internal
- # release number, the new results will overwrite the old results.
- pushd ${TestSuiteResultPath} > /dev/null
- Target=CGAL-${CgalInternalVersion}
- if [ ! -d ${Target} ]; then
- # do all the shifting only if test suite is new
- declare -i count=${TestSuiteHistory}
- if [ -r History.${count} ]; then
- subdir=`cat History.${count}`
- if [ -d $subdir ]; then \rm -fr $subdir ; fi
- \rm -f History.${count}
- fi
- while [ $count -gt 1 ] ; do
- oldcount=$count
- count=$count-1
- if [ -r History.${count} ]; then
- subdir=`cat History.${count}`
- if [[ ${oldcount} -gt ${TestSuiteFullHistory} && \
- -d $subdir ]]; then
- \rm -f $subdir/*.ps.gz ;
- for f in ${subdir}/* ; do
- if [ -d $f ]; then \rm -fr $f ; fi
- done
- # also eliminate dead links in index.html to doc.
- \mv ${subdir}/index.html ${subdir}/bak
- \cat ${subdir}/bak | sed 's/\(class=\"manual\">\).*\(<\/td>\)/\1 -- \2/g' > ${subdir}/index.html
- \chmod 644 ${subdir}/index.html
- fi
- \mv History.${count} History.${oldcount}
- fi
- done
- echo -n "${Target}" > History.1
- \mkdir ${Target}
- \chmod 644 History.1
- \chmod 755 ${Target}
- if [ -h LAST ]; then \rm -f LAST ; fi
- \ln -s ${Target} LAST
- fi
- popd > /dev/null
- \cp -r testsuite/* ${TestSuiteResultPath}/${Target}
- \rm -r testsuite
- # set proper read rights for the web server
- find ${TestSuiteResultPath}/${Target} -type d -exec chmod 755 {} \; -o -type f -exec chmod 644 {} \;
- # send email notification
- if [ "${TestSuiteResultEmail}" != "" ]; then
- # Use this line on Sun Solaris systems
- # printf "Subject: [automatic] New manual test results ${Target}\n\n\n${TestSuiteResultUrl}/${Target}\n" | ${Sendmail} ${TestSuiteResultEmail}
- # use this line on Linux systems
- printf "\n${TestSuiteResultUrl}/${Target}\n" | ${Sendmail} -s "[automatic] New manual test results ${Target}" ${TestSuiteResultEmail}
- fi
- fi
- fi
-}
-
-#_____________________________________________________________________.
-#=====================================================================#
-# #
-# main: read resource file and initialize globals #
-# #
-#_____________________________________________________________________#
-#=====================================================================#
-
-# Selects the different output formats supported. If any option is
-# given, reset all Make's and set them explicitly only.
-SetMakePS=0
-SetMakePDF=0
-SetMakeHTML=0
-DoCmdLog=0
-Parameters=""
-SubModules=""
-# becomes effective then used with -testsuite. default=1 :
-DoPublishTestsuiteResults=1
-
-while [ $# -gt 0 ] ; do
- case "$1" in
- -h | --help)
- usage
- exit 0
- ;;
- -V | --version)
- version
- exit 0
- ;;
- -ps) SetMakePS=1
- ;;
- -pdf) SetMakePDF=1
- ;;
- -html) SetMakeHTML=1
- ;;
- -linklint) TestLinkLint=1
- ;;
- -wrapper) MakeWrapperOnly=1
- ;;
- -nopublish)
- DoPublishTestsuiteResults=0
- ;;
- -testsuite)
- MakeTestSuiteResult=1
- SubModules="all"
- ;;
- -k) KeepLog=1
- NoLog=0
- ;;
- -n) NoLog=1
- KeepLog=0
- ;;
- -q) Quiet=1
- ;;
- -qq) RealQuiet=1
- Quiet=1
- ;;
- -cmdlog) DoCmdLog=1
- ;;
- -s) Sum=1 ;;
- -v) Verbose=1 ;;
- -sub-modules=*)
- if [ "$1" != "${1/-sub-modules=/}" ]; then
- SubModules=${1/-sub-modules=/}
- SubModules=${SubModules//,/ }
- fi
- ;;
- -*) echo "${ErrorColor}ERROR${ResetColor}: Unknow option '$1'." 1>&2
- usage
- exit 2
- ;;
- *) Parameters="${Parameters} `echo $1 | sed 's/[/]$//'`"
- # a trailing / (typical for directories) was removed
- if [[ ! -r $1 && ! -d $1 && ! -r $1.tex ]]; then
- echo "${ErrorColor}ERROR${ResetColor}: '$1' must be a Module (tex-file) or Package (directory)." 1>&2
- usage
- exit 2
- fi
- ;;
- esac
- shift
-done
-
-# Selects the different output formats supported. If any option is
-# given, reset all Make's and set them explicitly only.
-if [[ ${SetMakePS} -eq 1 || ${SetMakePDF} -eq 1 || ${SetMakeHTML} -eq 1 ]]; then
- MakePS=${SetMakePS}
- MakePDF=${SetMakePDF}
- MakeHTML=${SetMakeHTML}
-fi
-if [ $MakeTestSuiteResult -eq 1 ]; then
- NoLog=0
- KeepLog=1
-fi
-
-# Prepare TEXINPUTS and LATEX_CONV_INPUTS
-if [ -r Manual/cgal_manual.sty ]; then # case 1: internal release
- export TEXINPUTS=".:../examples:../demo:${TEXINPUTS}"
- export LATEX_CONV_INPUTS=".:../examples:../demo:${LATEX_CONV_INPUTS}"
- cmdlog -noexec 'export TEXINPUTS=".:../examples:../demo:${TEXINPUTS}"'
- cmdlog -noexec 'export LATEX_CONV_INPUTS=".:../examples:../demo:${LATEX_CONV_INPUTS}"'
-elif [ -r ../../Manual/doc_tex/Manual/cgal_manual.sty ]; then # case 2: package
- export TEXINPUTS=".:../../Manual/doc_tex:../examples:../demo:${TEXINPUTS}"
- export LATEX_CONV_INPUTS=".:../../Manual/doc_tex:../examples:../demo:${LATEX_CONV_INPUTS}"
- cmdlog -noexec 'export TEXINPUTS=".:../../Manual/doc_tex:../examples:../demo:${TEXINPUTS}"'
- cmdlog -noexec 'export LATEX_CONV_INPUTS=".:../../Manual/doc_tex:../examples:../demo:${LATEX_CONV_INPUTS}"'
-else
- export TEXINPUTS=".:../examples:../demo:${TEXINPUTS}"
- export LATEX_CONV_INPUTS=".:../examples:../demo:${LATEX_CONV_INPUTS}"
- cmdlog -noexec 'export TEXINPUTS=".:../examples:../demo:${TEXINPUTS}"'
- cmdlog -noexec 'export LATEX_CONV_INPUTS=".:../examples:../demo:${LATEX_CONV_INPUTS}"'
- # case 3: all others, need to be checked if it is already in searchpath
- if [ "`find_in_search_path Manual/cgal_manual.sty ${TEXINPUTS}`" == "" ]; then
- echo "${ErrorColor}ERROR${ResetColor}: Could not find Manual/cgal_manual.sty in "'$TEXINPUTS'" search path." 1>&2
- fi
- if [ "`find_in_search_path Manual/cgal_manual.sty ${LATEX_CONV_INPUTS}`" == "" ]; then
- echo "${ErrorColor}ERROR${ResetColor}: Could not find Manual/cgal_manual.sty in "'$LATEX_CONV_INPUTS'" search path." 1>&2
- fi
-fi
-
-# Prepare BIBINPUTS
-if [ -r Manual/cgal_manual.bib ]; then # case 1: internal release
- export BIBINPUTS=".:${BIBINPUTS}"
- cmdlog -noexec 'export BIBINPUTS=".:${BIBINPUTS}"'
-elif [ -r ../../Manual/doc_tex/Manual/cgal_manual.bib ]; then # case 2: package
- export BIBINPUTS="../../Manual/doc_tex:${BIBINPUTS}"
- cmdlog -noexec 'export BIBINPUTS="../../Manual/doc_tex:${BIBINPUTS}"'
-else
- # case 3: all others, need to be checked if it is already in searchpath
- if [ "`find_in_search_path Manual/cgal_manual.bib ${BIBINPUTS}`" == "" ]; then
- echo "${ErrorColor}ERROR${ResetColor}: Could not find Manual/cgal_manual.bib in "'$BIBINPUTS'" search path." 1>&2
- fi
-fi
-
-# Prepare example and demo directories (i.e., strip license headers)
-
-EXAMPLECODEDIRECTORIES=""
-if [ -d ../demo ] ; then
- EXAMPLECODEDIRECTORIES="../demo"
-fi
-
-if [ -d ../examples ] ; then
- EXAMPLECODEDIRECTORIES="$EXAMPLECODEDIRECTORIES ../examples"
-fi
-
-if [ -n "$EXAMPLECODEDIRECTORIES" ]; then
- find $EXAMPLECODEDIRECTORIES -name "*.cpp" -or -name "*.h" | while read f ; do
- cmdlog "echo $f | sed 's/[\.][\.][\/]//' > $f.filename"
- cmdlog "cat $f | expand | perl -e 'while(<>) { if( \$_ !~ /(^\/\/)|(^\s\*\$)/ ) { print; last; } } while(<>) { print; }' > $f.noheader"
- done
-fi
-
-GlobalReturnStatus=0
-if [ $MakeTestSuiteResult -eq 1 ]; then
- # needed for linklint
- ln -s ../{demo,examples,include} .
- testsuite_begin
-fi
-if [[ "$Parameters" == "" ]]; then
- # no arguments, make Module manuals first
- for m in *[Mm]anual.tex ; do
- make_module $m
- done
- if [ $MakeTestSuiteResult -eq 1 ]; then testsuite_middle ; fi
-
- # make Package manuals second
- ManRefList=""
- for m in * ; do
- if [[ -d $m && -r $m/main.tex ]]; then # it's a package
- # make sure that Manual and Manual_ref are matched up
- if [[ -d ${m}_ref && -r ${m}_ref/main.tex ]]; then
- ManRefList="$ManRefList ${m}_ref"
- make_manual $m ${m}_ref
- elif ! is_in_list $m $ManRefList ; then
- # check that we did not handle it already as ${m}_ref
- make_manual $m
- fi
- fi
- done
-else
- # make manuals given explicitly in the argumentlist
- # make Module manuals first
- for m in ${Parameters} ; do
- if is_module $m ; then
- make_module $m
- fi
- done
- if [ $MakeTestSuiteResult -eq 1 ]; then testsuite_middle ; fi
-
- # make Package manuals second
- ManRefList=""
- for m in ${Parameters} ; do
- if ! is_module $m ; then
- # make sure that Manual and Manual_ref are matched up
- if is_in_list ${m}_ref ${Parameters} ; then
- ManRefList="$ManRefList ${m}_ref"
- make_manual $m ${m}_ref
- elif ! is_in_list $m $ManRefList ; then
- # check that we did not handle it already as ${m}_ref
- make_manual $m
- fi
- fi
- done
-fi
-
-
-# cleanup again
-find $EXAMPLECODEDIRECTORIES -name "*.cpp" -or -name "*.h" | while read f ; do
- cmdlog "rm -f $f.filename $f.noheader"
-done
-
-if [ $MakeTestSuiteResult -eq 1 ]; then
- # remove temporary links
- rm {demo,examples,include}
- testsuite_end
-fi
-
-exit $GlobalReturnStatus
diff --git a/Manual/doc_html/Manual/index.html b/Manual/doc_html/Manual/index.html
deleted file mode 100644
index ce6b70c0d9a..00000000000
--- a/Manual/doc_html/Manual/index.html
+++ /dev/null
@@ -1,23 +0,0 @@
-
-
-
-
-
- CGAL - Computational Geometry Algorithms Library
-
-
-
-
-
-
CGAL Manual
-
-
-You can download the manual as tarball
-from the
-CGAL Download Page, or with the Windows Installer.
-
CGAL is distributed under a dual-license scheme. CGAL can be used together
-with Open Source software free of charge. Using CGAL in other contexts can be
-done by obtaining a commercial license from
-GeometryFactory.
-For more details see the License page.
-
-