CGAL · lrineau · Mar 7, 2019 · Mar 5, 2019
diff --git a/Documentation/doc/resources/1.8.13/BaseDoxyfile.in b/Documentation/doc/resources/1.8.13/BaseDoxyfile.in
@@ -266,6 +266,8 @@ ALIASES                = "sc{1}=<span style=\"font-variant: small-caps;\">\1</sp
                          "cgalAdvancedEnd=\htmlonly </div> \endhtmlonly" \
                          "cgalAdvancedFunction=This is an advanced function." \
                          "cgalAdvancedClass=This is an advanced class." \
+                         "cgalAdvancedType=This is an advanced type." \
+                         "cgalAdvancedConcept=This is an advanced concept." \
                          "cgalRequiresCPP11=\warning This function requires a C++11 compiler." \
                          "cgalPkgPicture{1}=<div class=\"PkgImage\"> \n \image html \1 \n</div>" \
                          "cgalPkgSummaryBegin=<div class=\"PkgSummary\">" \

diff --git a/Documentation/doc/resources/1.8.14/BaseDoxyfile.in b/Documentation/doc/resources/1.8.14/BaseDoxyfile.in
@@ -267,6 +267,8 @@ ALIASES                = "sc{1}=<span style=\"font-variant: small-caps;\">\1</sp
                          "cgalAdvancedEnd=\htmlonly </div> \endhtmlonly" \
                          "cgalAdvancedFunction=This is an advanced function." \
                          "cgalAdvancedClass=This is an advanced class." \
+                         "cgalAdvancedType=This is an advanced type." \
+                         "cgalAdvancedConcept=This is an advanced concept." \
                          "cgalRequiresCPP11=\warning This function requires a C++11 compiler." \
                          "cgalPkgPicture{1}=<div class=\"PkgImage\"> ^^ \image html \1 ^^</div>" \
                          "cgalPkgSummaryBegin=<div class=\"PkgSummary\">" \

diff --git a/Documentation/doc/resources/1.8.4/BaseDoxyfile.in b/Documentation/doc/resources/1.8.4/BaseDoxyfile.in
@@ -251,6 +251,8 @@ ALIASES += "cgalAdvancedBegin=\htmlonly <div class=\"CGALAdvanced\"> <div>Advanc
 ALIASES += "cgalAdvancedEnd=\htmlonly </div> \endhtmlonly"
 ALIASES += "cgalAdvancedFunction=This is an advanced function."
 ALIASES += "cgalAdvancedClass=This is an advanced class."
+ALIASES += "cgalAdvancedType=This is an advanced type."
+ALIASES += "cgalAdvancedConcept=This is an advanced concept."
 
 ALIASES += "cgalRequiresCPP11=\warning This function requires a C++11 compiler."
 

diff --git a/Inscribed_areas/doc/Inscribed_areas/Concepts/ExtremalPolygonTraits_2.h b/Inscribed_areas/doc/Inscribed_areas/Concepts/ExtremalPolygonTraits_2.h
@@ -3,6 +3,7 @@
 \ingroup PkgInscribedAreasConcepts
 \cgalConcept
 
+\cgalAdvancedConcept
 \cgalAdvancedBegin
 The concept `ExtremalPolygonTraits_2` provides the types and
 operations needed to compute a maximal \f$ k\f$-gon that can be

diff --git a/...triangulation_2/doc/Periodic_2_triangulation_2/CGAL/Periodic_2_Delaunay_triangulation_2.h b/...triangulation_2/doc/Periodic_2_triangulation_2/CGAL/Periodic_2_Delaunay_triangulation_2.h
@@ -305,6 +305,7 @@ class Periodic_2_Delaunay_triangulation_2 : public Periodic_2_triangulation_2<Tr
 /// @{
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   Checks the combinatorial validity of the triangulation and the
   validity of its geometric embedding (see
@@ -319,6 +320,7 @@ class Periodic_2_Delaunay_triangulation_2 : public Periodic_2_triangulation_2<Tr
   is_valid(bool verbose = false) const;
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   Checks the combinatorial and geometric validity of the cell (see
   Section \ref P2Triangulation2secintro). Also checks that the

diff --git a/Periodic_2_triangulation_2/doc/Periodic_2_triangulation_2/CGAL/Periodic_2_triangulation_2.h b/Periodic_2_triangulation_2/doc/Periodic_2_triangulation_2/CGAL/Periodic_2_triangulation_2.h
@@ -438,6 +438,7 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
 /// @{
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   Returns a reference to the triangulation data structure.
   \cgalAdvancedEnd
@@ -473,6 +474,7 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
 /// @{
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   The current triangulation remains a triangulation in the 1-sheeted
   covering space even after adding points if this method returns
@@ -486,6 +488,7 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
   bool is_extensible_triangulation_in_1_sheet_h1() const;
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   The same as `is_extensible_triangulation_in_1_sheet_h1()` but with
   a more precise heuristic, i.e. it might answer `true` in cases in which
@@ -498,6 +501,7 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
   bool is_extensible_triangulation_in_1_sheet_h2() const;
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   Returns `true` if the current triangulation would still be a
   triangulation in the 1-sheeted covering space, returns `false` otherwise.
@@ -506,6 +510,7 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
   bool is_triangulation_in_1_sheet() const;
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   Converts the current triangulation into the same periodic
   triangulation in the 1-sheeted covering space.
@@ -515,6 +520,7 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
   void convert_to_1_sheeted_covering();
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   Converts the current triangulation into the same periodic
   triangulation in the 9-sheeted covering space.
@@ -971,13 +977,15 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
 /// @{
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   Inserts the first vertex.
   \cgalAdvancedEnd
   */
   Vertex_handle insert_first(const Point& p);
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   Inserts vertex `v` in face
   `f`. Face `f` is modified,
@@ -988,6 +996,7 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
   Vertex_handle insert_in_face(const Point& p, Face_handle f);
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   Removes a vertex of degree three. Two of the incident faces are
   destroyed, the third one is modified. \pre Vertex `v` is a vertex with degree three.
@@ -996,6 +1005,7 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
   void remove_degree_3(Vertex_handle v);
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   Removes the unique vertex in the
   triangulation.
@@ -1006,10 +1016,11 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
 
 
   /*!
-      \cgalAdvancedBegin
-    creates a new vertex `v` and use it to star the hole
-    whose boundary is described by the sequence of edges
-    `[edge_begin, edge_end]`. Returns a handle to the new vertex.
+  \cgalAdvancedFunction
+  \cgalAdvancedBegin
+  creates a new vertex `v` and use it to star the hole
+  whose boundary is described by the sequence of edges
+  `[edge_begin, edge_end]`. Returns a handle to the new vertex.
 
   \pre The triangulation is a triangulation of 1 sheet
     \cgalAdvancedEnd
@@ -1020,6 +1031,7 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
                            EdgeIt edge_end);
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   same as above, except that the algorithm
   first recycles faces in the sequence `[face_begin, face_end]`
@@ -1036,6 +1048,7 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
                            FaceIt face_end);
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   Changes the domain. Note that this function calls `clear()`,
   i.e., it erases the existing triangulation.
@@ -1084,6 +1097,7 @@ class Periodic_2_triangulation_2 : public Triangulation_cw_ccw_2
 /// @{
 
   /*!
+  \cgalAdvancedFunction
   \cgalAdvancedBegin
   Checks the combinatorial validity of the triangulation and
   also the validity of its geometric embedding.

diff --git a/Point_set_3/include/CGAL/Point_set_3.h b/Point_set_3/include/CGAL/Point_set_3.h
@@ -939,13 +939,15 @@ class Point_set_3
 
 
 #ifdef DOXYGEN_RUNNING
+  /// \cgalAdvancedType
   /// \cgalAdvancedBegin  
   /// Model of `OutputIterator` used to insert elements by defining
   /// the value of the property `Property`.
   /// \cgalAdvancedEnd  
   template <class Property>
   using Property_back_inserter = unspecified_type;
 
+  /// \cgalAdvancedType
   /// \cgalAdvancedBegin  
   /// Model of `WritablePropertyMap` based on `Property` and that
   /// is allowed to push new items to the point set if needed.
@@ -1025,26 +1027,30 @@ class Point_set_3
   };
   /// \endcond      
 
+  /// \cgalAdvancedType
   /// \cgalAdvancedBegin
   /// Back inserter on indices
   /// \cgalAdvancedEnd
   typedef Property_back_inserter<Index_map> Index_back_inserter; 
+  /// \cgalAdvancedType
   /// \cgalAdvancedBegin
   /// Back inserter on points
   /// \cgalAdvancedEnd
   typedef Property_back_inserter<Point_map> Point_back_inserter;
+  /// \cgalAdvancedType
   /// \cgalAdvancedBegin
   /// Property map for pushing new points
   /// \cgalAdvancedEnd
   typedef Push_property_map<Point_map> Point_push_map;
+  /// \cgalAdvancedType
   /// \cgalAdvancedBegin
   /// Property map for pushing new vectors
   /// \cgalAdvancedEnd
   typedef Push_property_map<Vector_map> Vector_push_map;
 
   /*!
-    \cgalAdvancedBegin
     \cgalAdvancedFunction
+    \cgalAdvancedBegin
     \brief Returns the push property map of the given property.
 
     \tparam T type of the property.
@@ -1063,8 +1069,8 @@ class Point_set_3
     return Push_property_map<Property_map<T> > (this, &prop, size());
   }
   /*!
-    \cgalAdvancedBegin
     \cgalAdvancedFunction
+    \cgalAdvancedBegin
     \brief Returns the push property map of the point property.
     \cgalAdvancedEnd
   */
@@ -1073,8 +1079,8 @@ class Point_set_3
     return Point_push_map (this, &m_points, size());
   }
   /*!
-    \cgalAdvancedBegin
     \cgalAdvancedFunction
+    \cgalAdvancedBegin
     \brief Returns the push property map of the normal property.
 
     \note The normal property must have been added to the point set
@@ -1086,8 +1092,8 @@ class Point_set_3
     return Vector_push_map (this, &m_normals, size());
   }
   /*!
-    \cgalAdvancedBegin
     \cgalAdvancedFunction
+    \cgalAdvancedBegin
     \brief Returns the back inserter on the index property.
     \cgalAdvancedEnd
   */
@@ -1096,8 +1102,8 @@ class Point_set_3
     return Index_back_inserter (this, &m_indices, size());
   }
   /*!
-    \cgalAdvancedBegin
     \cgalAdvancedFunction
+    \cgalAdvancedBegin
     \brief Returns the back inserter on the point property.
     \cgalAdvancedEnd
   */

diff --git a/Spatial_searching/doc/Spatial_searching/Concepts/Splitter.h b/Spatial_searching/doc/Spatial_searching/Concepts/Splitter.h
@@ -2,6 +2,7 @@
 \ingroup PkgSpatialSearchingDConcepts
 \cgalConcept
 
+\cgalAdvancedConcept
 \cgalAdvancedBegin
 The concept `Splitter` defines the requirements for a function object class implementing a splitting rule. 
 \cgalAdvancedEnd

diff --git a/Surface_mesh_skeletonization/include/CGAL/Mean_curvature_flow_skeletonization.h b/Surface_mesh_skeletonization/include/CGAL/Mean_curvature_flow_skeletonization.h
@@ -461,6 +461,7 @@ std::size_t collapse_short_edges();
   /// \name Vertex Motion Parameters
   /// @{
 
+  /// \cgalAdvancedFunction
   /// \cgalAdvancedBegin
   /// Controls the velocity of movement and approximation quality:
   /// decreasing this value makes the mean curvature flow based contraction converge
@@ -480,7 +481,8 @@ std::size_t collapse_short_edges();
   {
     return m_is_medially_centered;
   }
-
+
+  /// \cgalAdvancedFunction
   /// \cgalAdvancedBegin
   /// Controls the smoothness of the medial approximation:
   /// increasing this value results in a (less smooth) skeleton closer

diff --git a/TDS_3/doc/TDS_3/Concepts/TriangulationDataStructure_3.h b/TDS_3/doc/TDS_3/Concepts/TriangulationDataStructure_3.h
@@ -118,6 +118,7 @@ Can be `CGAL::Sequential_tag` or `CGAL::Parallel_tag`. If it is
 typedef unspecified_type Concurrency_tag;
 
 /*!
+\cgalAdvancedType
 \cgalAdvancedBegin
 This template class allows to get the type of a triangulation 
 data structure that only changes the vertex type. It has to define a type 
@@ -130,6 +131,7 @@ template <typename Vb2>
 using Rebind_vertex = unspecified_type;
 
 /*!
+\cgalAdvancedType
 \cgalAdvancedBegin
 This template class allows to get the type of a triangulation 
 data structure that only changes the cell type. It has to define a type 

diff --git a/Triangulation/doc/Triangulation/CGAL/Triangulation.h b/Triangulation/doc/Triangulation/CGAL/Triangulation.h
@@ -254,6 +254,7 @@ Returns a const reference to the underlying triangulation data structure.
 const Triangulation_ds & tds() const;
 
 /*!
+\cgalAdvancedFunction
 \cgalAdvancedBegin
 Returns a non-const
 reference to the underlying triangulation data structure.

diff --git a/Triangulation/doc/Triangulation/CGAL/Triangulation_data_structure.h b/Triangulation/doc/Triangulation/CGAL/Triangulation_data_structure.h
@@ -74,6 +74,7 @@ bool is_valid(bool verbose = true) const;
 /// @{
 
 /*!
+\cgalAdvancedType
 \cgalAdvancedBegin
 This template class allows to get the type of a triangulation
 data structure that only changes the vertex type. It has to define a type
@@ -103,6 +104,7 @@ using Rebind_full_cell = unspecified_type;
 /// @{
 
 /*!
+\cgalAdvancedFunction
 \cgalAdvancedBegin
 A set `C` of full cells satisfying the same condition as in method 
 `Triangulation_data_structure::insert_in_hole()` is assumed to be marked. This 

diff --git a/Triangulation/doc/Triangulation/CGAL/Triangulation_ds_full_cell.h b/Triangulation/doc/Triangulation/CGAL/Triangulation_ds_full_cell.h
@@ -60,7 +60,8 @@ class Triangulation_ds_full_cell {
 /// \name Validity Check 
 /// @{
 
-/*! 
+/*!
+\cgalAdvancedFunction
 \cgalAdvancedBegin
 Implements the validity checks required by the concept 
 `TriangulationDSFullCell`.

diff --git a/Triangulation/doc/Triangulation/CGAL/Triangulation_ds_vertex.h b/Triangulation/doc/Triangulation/CGAL/Triangulation_ds_vertex.h
@@ -41,6 +41,7 @@ class Triangulation_ds_vertex {
 /// @{
 
 /*! 
+\cgalAdvancedFunction
 \cgalAdvancedBegin
 Implements the validity checks required by the concept 
 `TriangulationDSVertex`. Does not implement additional checks. 

diff --git a/Triangulation/doc/Triangulation/Concepts/TriangulationDataStructure.h b/Triangulation/doc/Triangulation/Concepts/TriangulationDataStructure.h
@@ -432,6 +432,7 @@ Inserts a vertex in the triangulation data structure by subdividing the
 Vertex_handle insert_in_facet(const Facet & ft);
 
 /*!
+\cgalAdvancedFunction
 \cgalAdvancedBegin
 Removes the full cells in the range \f$ C=\f$`[s, e)`, inserts a vertex 
 at position `p` and fills the hole by connecting

diff --git a/Triangulation_2/doc/Triangulation_2/CGAL/Constrained_triangulation_plus_2.h b/Triangulation_2/doc/Triangulation_2/CGAL/Constrained_triangulation_plus_2.h
@@ -406,7 +406,7 @@ The simplification algorithm uses the following types and functions.
 
 /*!
 \cgalAdvancedBegin
-An iterator on the points of the of the original constraint
+An iterator on the points of the original constraint
 before simplification steps are applied. The value type of this iterator is `Point`.
 A \link Constrained_triangulation_plus_2::Vertices_in_constraint_iterator `Vertices_in_constraint_iterator`\endlink can be converted into
 a `Points_in_constraint_iterator`, but not the other way around.
@@ -416,20 +416,23 @@ typedef unspecified_type Points_in_constraint_iterator;
 
 
 /*!
+\cgalAdvancedFunction
 \cgalAdvancedBegin
 Returns an iterator to the first point on the constraint before any simplification step.
 \cgalAdvancedEnd
 */
 Points_in_constraint_iterator points_in_constraint_begin(Constraint_id cid) const;
 
 /*!
+\cgalAdvancedFunction
 \cgalAdvancedBegin
 Returns an iterator past the last point on the constraint before any simplification step.
 \cgalAdvancedEnd
 */
 Points_in_constraint_iterator points_in_constraint_end(Constraint_id cid) const ;
 
 /*!
+\cgalAdvancedFunction
 \cgalAdvancedBegin
 Removes the vertex at `vicq` from the constraint and the triangulation.
 The point of that vertex remains stored in the sequence of original points
@@ -452,6 +455,7 @@ void
 simplify(Vertices_in_constraint_iterator vicq);
 
 /*!
+\cgalAdvancedFunction
 \cgalAdvancedBegin
 Removes the original points that correspond to vertices in the constraint `cid` which have
 been removed by the `simplify()` function.
@@ -462,6 +466,7 @@ remove_points_without_corresponding_vertex(Constraint_id cid);
 
 
 /*!
+\cgalAdvancedFunction
 \cgalAdvancedBegin
 Removes all original points that correspond to vertices in the constraints which have
 been removed by the `simplify()` function.