From 33cd9af6cd4e5f9656d28d920d3fd9925d82451e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Philipp=20M=C3=B6ller?= Date: Mon, 1 Oct 2012 14:56:32 +0000 Subject: [PATCH] Remove the last remnants of \require and turn them into \requires --- .../Alpha_shapes_3/CGAL/Fixed_alpha_shape_3.h | 4 ++-- .../CGAL/Approximate_min_ellipsoid_d.h | 7 +++++-- .../doc/Bounding_volumes/CGAL/Min_annulus_d.h | 16 ++++++++-------- .../doc/Bounding_volumes/CGAL/Min_circle_2.h | 8 ++++---- .../doc/Bounding_volumes/CGAL/Min_ellipse_2.h | 8 ++++---- .../Bounding_volumes/CGAL/min_quadrilateral_2.h | 6 +++--- .../CGAL/rectangular_p_center_2.h | 2 +- .../Concepts/MinSphereOfSpheresTraits.h | 3 ++- STL_Extension/doc/STL_Extension/CGAL/Sixtuple.h | 4 +--- STL_Extension/doc/STL_Extension/CGAL/algorithm.h | 2 +- STL_Extension/doc/STL_Extension/CGAL/iterator.h | 2 +- STL_Extension/doc/STL_Extension/CGAL/utility.h | 7 +++++-- .../doc/STL_Extension/STL_Extension.txt | 2 +- .../doc/Spatial_sorting/CGAL/Hilbert_sort_2.h | 2 +- .../doc/Spatial_sorting/CGAL/Hilbert_sort_3.h | 2 +- .../doc/Spatial_sorting/CGAL/Hilbert_sort_d.h | 2 +- .../doc/Spatial_sorting/CGAL/Multiscale_sort.h | 2 +- 17 files changed, 42 insertions(+), 37 deletions(-) diff --git a/Alpha_shapes_3/doc/Alpha_shapes_3/CGAL/Fixed_alpha_shape_3.h b/Alpha_shapes_3/doc/Alpha_shapes_3/CGAL/Fixed_alpha_shape_3.h index fae0ab35de6..e97a0df95a5 100644 --- a/Alpha_shapes_3/doc/Alpha_shapes_3/CGAL/Fixed_alpha_shape_3.h +++ b/Alpha_shapes_3/doc/Alpha_shapes_3/CGAL/Fixed_alpha_shape_3.h @@ -86,7 +86,7 @@ Builds an alpha shape data structure for the points in the range \f$ \left[\right.\f$`first`, `last`\f$ \left.\right)\f$ and set the alpha value to `alpha`. -\require The `value_type` of `first` and `last` is `Point` (the type point of the underlying triangulation.) +\requires The `value_type` of `first` and `last` is `Point` (the type point of the underlying triangulation.) */ template < class InputIterator > Alpha_shape_3( @@ -204,7 +204,7 @@ Inserts the alpha shape `A` into the stream `os`. Defined in \ref CGAL/IO/io.h -\require The insert operator must be defined for `GT::Point`. +\requires The insert operator must be defined for `GT::Point`. \relates Fixed_alpha_shape_3 */ ostream& operator<<(ostream& os, const Fixed_alpha_shape_3
& A); diff --git a/Bounding_volumes/doc/Bounding_volumes/CGAL/Approximate_min_ellipsoid_d.h b/Bounding_volumes/doc/Bounding_volumes/CGAL/Approximate_min_ellipsoid_d.h index bd0bf1381be..2e18ba198f8 100644 --- a/Bounding_volumes/doc/Bounding_volumes/CGAL/Approximate_min_ellipsoid_d.h +++ b/Bounding_volumes/doc/Bounding_volumes/CGAL/Approximate_min_ellipsoid_d.h @@ -211,8 +211,11 @@ worse approximation ratio (and \f$ \epsilon\f$ can thus be larger than `eps` in general). In any case, the number \f$ \epsilon\f$ (and with this, the achived approximation \f$ 1+\epsilon\f$) can be queried by calling the routine -`achieved_epsilon()` discussed below. \require `Iterator` must be a model for concept `InputIterator` -with value type `Point`. \pre The dimension \f$ d\f$ of the input points must be at least \f$ 2\f$, and \f$ \epsilon>0\f$. +`achieved_epsilon()` discussed below. + +\requires `Iterator` must be a model for concept `InputIterator` with value type `Point`. + +\pre The dimension \f$ d\f$ of the input points must be at least \f$ 2\f$, and \f$ \epsilon>0\f$. */ template < class Iterator > Approximate_min_ellipsoid_d(double eps, diff --git a/Bounding_volumes/doc/Bounding_volumes/CGAL/Min_annulus_d.h b/Bounding_volumes/doc/Bounding_volumes/CGAL/Min_annulus_d.h index f2e653a8db5..a48d225fa09 100644 --- a/Bounding_volumes/doc/Bounding_volumes/CGAL/Min_annulus_d.h +++ b/Bounding_volumes/doc/Bounding_volumes/CGAL/Min_annulus_d.h @@ -135,7 +135,7 @@ std::ostream& stream = std::cout); initializes `min_annulus` to \f$ ma(P)\f$ with \f$ P\f$ being the set of points in the range [`first`,`last`). -\require The value type of `InputIterator` is `Point`. +\requires The value type of `InputIterator` is `Point`. \pre All points have the same dimension. */ template < class InputIterator > @@ -242,7 +242,7 @@ outer_support_points_end( ) const; /*! returns the center of `min_annulus`. -\require An implicit conversion from `ET` to `RT` is available. +\requires An implicit conversion from `ET` to `RT` is available. \pre `min_annulus` is not empty. */ Point center( ) const; @@ -250,7 +250,7 @@ Point center( ) const; /*! returns the squared inner radius of `min_annulus`. -\require An implicit conversion from `ET` to `RT` is available. +\requires An implicit conversion from `ET` to `RT` is available. \pre `min_annulus` is not empty. */ FT squared_inner_radius( ) const; @@ -258,7 +258,7 @@ FT squared_inner_radius( ) const; /*! returns the squared outer radius of `min_annulus`. -\require An implicit conversion from `ET` to `RT` is available. +\requires An implicit conversion from `ET` to `RT` is available. \pre `min_annulus` is not empty. */ FT squared_outer_radius( ) const; @@ -373,7 +373,7 @@ void clear( ); sets `min_annulus` to \f$ ma(P)\f$, where \f$ P\f$ is the set of points in the range [`first`,`last`). -\require The value type of `InputIterator` is `Point`. +\requires The value type of `InputIterator` is `Point`. \pre All points have the same dimension. */ template < class InputIterator > @@ -391,7 +391,7 @@ void insert( const Point& p); inserts the points in the range [`first`,`last`) into `min_annulus` and recomputes the smallest enclosing annulus. -\require The value type of `InputIterator` is `Point`. +\requires The value type of `InputIterator` is `Point`. \pre All points have the same dimension. If `min_annulus` is not empty, this dimension must be equal to `min_annulus.ambient_dimension()`. */ template < class InputIterator > @@ -439,7 +439,7 @@ const Traits& traits( ) const; /*! writes `min_annulus` to output stream `os`. -\require The output operator is defined for `Point`. +\requires The output operator is defined for `Point`. \relates Min_annulus_d */ std::ostream& @@ -449,7 +449,7 @@ const Min_annulus_d& min_annulus); /*! reads `min_annulus` from input stream `is`. -\require The input operator is defined for `Point`. +\requires The input operator is defined for `Point`. \relates Min_annulus_d */ std::istream& diff --git a/Bounding_volumes/doc/Bounding_volumes/CGAL/Min_circle_2.h b/Bounding_volumes/doc/Bounding_volumes/CGAL/Min_circle_2.h index a97879b4db1..efa3215bb0f 100644 --- a/Bounding_volumes/doc/Bounding_volumes/CGAL/Min_circle_2.h +++ b/Bounding_volumes/doc/Bounding_volumes/CGAL/Min_circle_2.h @@ -124,7 +124,7 @@ Usually, this will not be necessary, however, the algorithm's efficiency depends on the order in which the points are processed, and a bad order might lead to extremely poor performance (see example below). -\require The value type of `first` and `last` is `Point`. +\requires The value type of `first` and `last` is `Point`. */ template < class InputIterator > Min_circle_2( InputIterator first, @@ -299,7 +299,7 @@ inserts the points in the range [`first`,`last`) into `min_circle` and recomputes the smallest enclosing circle by calling `insert(p)` for each point `p` in [`first`,`last`). -\require The value type of `first` and `last` is `Point`. +\requires The value type of `first` and `last` is `Point`. */ template < class InputIterator > void insert( InputIterator first, @@ -350,7 +350,7 @@ const Traits& traits( ) const; /*! writes `min_circle` to output stream `os`. -\require The output operator is defined for `Point` (and for `Circle`, if pretty printing is used). +\requires The output operator is defined for `Point` (and for `Circle`, if pretty printing is used). \relates Min_circle_2 */ std::ostream& @@ -360,7 +360,7 @@ const Min_circle_2& min_circle); /*! reads `min_circle` from input stream `is`. -\require The input operator is defined for `Point`. +\requires The input operator is defined for `Point`. \relates Min_circle_2 */ std::istream& diff --git a/Bounding_volumes/doc/Bounding_volumes/CGAL/Min_ellipse_2.h b/Bounding_volumes/doc/Bounding_volumes/CGAL/Min_ellipse_2.h index 5581260b93f..57fc2ee01e7 100644 --- a/Bounding_volumes/doc/Bounding_volumes/CGAL/Min_ellipse_2.h +++ b/Bounding_volumes/doc/Bounding_volumes/CGAL/Min_ellipse_2.h @@ -113,7 +113,7 @@ Usually, this will not be necessary, however, the algorithm's efficiency depends on the order in which the points are processed, and a bad order might lead to extremely poor performance (see example below). -\require The value type of `first` and `last` is `Point`. +\requires The value type of `first` and `last` is `Point`. */ template < class InputIterator > Min_Ellipse_2( InputIterator first, @@ -312,7 +312,7 @@ inserts the points in the range [`first`,`last`) into `min_ellipse` and recomputes the smallest enclosing ellipse by calling `insert(p)` for each point `p` in [`first`,`last`). -\require The value type of `first` and `last` is `Point`. +\requires The value type of `first` and `last` is `Point`. */ template < class InputIterator > void insert( InputIterator first, @@ -368,7 +368,7 @@ const Traits& traits( ) const; /*! writes `min_ellipse` to output stream `os`. -\require The output operator is defined for `Point` (and for `Ellipse`, if pretty printing is used). +\requires The output operator is defined for `Point` (and for `Ellipse`, if pretty printing is used). \relates Min_ellipse_2 */ std::ostream& @@ -378,7 +378,7 @@ const Min_ellipse_2& min_ellipse); /*! reads `min_ellipse` from input stream `is`. -\require The input operator is defined for `Point`. +\requires The input operator is defined for `Point`. \relates Min_ellipse_2 */ std::istream& diff --git a/Bounding_volumes/doc/Bounding_volumes/CGAL/min_quadrilateral_2.h b/Bounding_volumes/doc/Bounding_volumes/CGAL/min_quadrilateral_2.h index 42d03639419..5440c402055 100644 --- a/Bounding_volumes/doc/Bounding_volumes/CGAL/min_quadrilateral_2.h +++ b/Bounding_volumes/doc/Bounding_volumes/CGAL/min_quadrilateral_2.h @@ -28,7 +28,7 @@ omitted, if `ForwardIterator` refers to a two-dimensional point type from one the \cgal kernels. In this case, a default traits class (`Min_quadrilateral_default_traits_2`) is used. -\require
    +\requires
    1. If `Traits` is specified, it is a model for `MinQuadrilateralTraits_2` and the value type `VT` of `ForwardIterator` is `Traits::Point_2`. Otherwise @@ -99,7 +99,7 @@ omitted, if `ForwardIterator` refers to a two-dimensional point type from one the \cgal kernels. In this case, a default traits class (`Min_quadrilateral_default_traits_2`) is used. -\require
        +\requires
        1. If `Traits` is specified, it is a model for `MinQuadrilateralTraits_2` and the value type `VT` of `ForwardIterator` is `Traits::Point_2`. Otherwise `VT` @@ -167,7 +167,7 @@ point type from one the \cgal kernels. In this case, a default traits class (`Min_quadrilateral_default_traits_2`) is used. -\require
            +\requires
            1. If `Traits` is specified, it is a model for `MinQuadrilateralTraits_2` and the value type `VT` of `ForwardIterator` is `Traits::Point_2`. Otherwise `VT` diff --git a/Bounding_volumes/doc/Bounding_volumes/CGAL/rectangular_p_center_2.h b/Bounding_volumes/doc/Bounding_volumes/CGAL/rectangular_p_center_2.h index 5c6fea22230..128d1fe65ea 100644 --- a/Bounding_volumes/doc/Bounding_volumes/CGAL/rectangular_p_center_2.h +++ b/Bounding_volumes/doc/Bounding_volumes/CGAL/rectangular_p_center_2.h @@ -227,7 +227,7 @@ can be omitted if `ForwardIterator` refers to a point type from the 2D-Kernel. In this case, a default traits class (`Rectangular_p_center_default_traits_2`) is used. -\require
                +\requires
                1. Either: (if no traits parameter is given) Value type of `ForwardIterator` is `CGAL::Point_2` for some representation class `K` and `FT` is equivalent to diff --git a/Bounding_volumes/doc/Bounding_volumes/Concepts/MinSphereOfSpheresTraits.h b/Bounding_volumes/doc/Bounding_volumes/Concepts/MinSphereOfSpheresTraits.h index 6bc9d0b1e25..db527f75fa5 100644 --- a/Bounding_volumes/doc/Bounding_volumes/Concepts/MinSphereOfSpheresTraits.h +++ b/Bounding_volumes/doc/Bounding_volumes/Concepts/MinSphereOfSpheresTraits.h @@ -38,7 +38,8 @@ typedef Hidden_type Sphere; /*! is a (exact or inexact) field number type. -\require Currently, `FT` must either be `double` or `float`, or an exact field number type. (An exact number type is one which evaluates arithmetic expressions involving the four basic operations and comparisions with infinite precision, that is, like in \f$ \R\f$.) + +\requires Currently, `FT` must either be `double` or `float`, or an exact field number type. (An exact number type is one which evaluates arithmetic expressions involving the four basic operations and comparisions with infinite precision, that is, like in \f$ \R\f$.) */ typedef Hidden_type FT; diff --git a/STL_Extension/doc/STL_Extension/CGAL/Sixtuple.h b/STL_Extension/doc/STL_Extension/CGAL/Sixtuple.h index 2d7fdf490f6..76e04f6e439 100644 --- a/STL_Extension/doc/STL_Extension/CGAL/Sixtuple.h +++ b/STL_Extension/doc/STL_Extension/CGAL/Sixtuple.h @@ -13,9 +13,7 @@ iterators) for accessing the elements of a container. \deprecated This class is deprecated, and will be removed in some future \cgal release. Please use CGAL::cpp11::array instead. -\require `T` must be `Assignable`. - - +\tparam `T` must be `Assignable`. */ template< typename T > class Sixtuple { diff --git a/STL_Extension/doc/STL_Extension/CGAL/algorithm.h b/STL_Extension/doc/STL_Extension/CGAL/algorithm.h index 3b9778c9711..37657c162e7 100644 --- a/STL_Extension/doc/STL_Extension/CGAL/algorithm.h +++ b/STL_Extension/doc/STL_Extension/CGAL/algorithm.h @@ -85,7 +85,7 @@ maximal element of the sequence \f$ (3,\,6,\,5)\f$. Hence the output is second component refers to the maximal element in the range [`first`, `last`). -\require `CompareMin` and `CompareMax` are adaptable binary +\requires `CompareMin` and `CompareMax` are adaptable binary function objects: `VT` \f$ \times\f$ `VT` \f$ \rightarrow\f$ `bool` where `VT` is the value type of `ForwardIterator`. */ diff --git a/STL_Extension/doc/STL_Extension/CGAL/iterator.h b/STL_Extension/doc/STL_Extension/CGAL/iterator.h index f29bdbfa89a..a1eff70bf96 100644 --- a/STL_Extension/doc/STL_Extension/CGAL/iterator.h +++ b/STL_Extension/doc/STL_Extension/CGAL/iterator.h @@ -401,7 +401,7 @@ additional argument. \models ::OutputIterator -\require `Container` provides a member function `insert(const Container::const_reference&)`. +\requires `Container` provides a member function `insert(const Container::const_reference&)`. */ template< typename Container > diff --git a/STL_Extension/doc/STL_Extension/CGAL/utility.h b/STL_Extension/doc/STL_Extension/CGAL/utility.h index 16118774591..224961765cb 100644 --- a/STL_Extension/doc/STL_Extension/CGAL/utility.h +++ b/STL_Extension/doc/STL_Extension/CGAL/utility.h @@ -159,7 +159,9 @@ Quadruple(T1 x, T2 y, T3 z, T4 w); constructs a quadruple such that `first` is constructed from `u`, `second` is constructed from `v`, `third` is constructed from `w`, -and `fourth` is constructed from `x`. \require Proper conversion operators exist from `U` to `T1`, `V` to `T2`, `W` to `T3`, and `X` to `T4`. +and `fourth` is constructed from `x`. + +\requires Proper conversion operators exist from `U` to `T1`, `V` to `T2`, `W` to `T3`, and `X` to `T4`. */ template Quadruple(U u, V v, W w, X x); @@ -354,7 +356,8 @@ Triple(T1 x, T2 y, T3 z); /*! constructs a triple such that `first` is constructed from `u`, `second` is constructed from `v`, and -`third` is constructed from `w`. \require Proper conversion operators exist from `U` to `T1`, `V` to `T2`, and `W` to `T3`. +`third` is constructed from `w`. +\requires Proper conversion operators exist from `U` to `T1`, `V` to `T2`, and `W` to `T3`. */ template Triple(U u, V v, W w); diff --git a/STL_Extension/doc/STL_Extension/STL_Extension.txt b/STL_Extension/doc/STL_Extension/STL_Extension.txt index ff760d67167..4ac247c6c32 100644 --- a/STL_Extension/doc/STL_Extension/STL_Extension.txt +++ b/STL_Extension/doc/STL_Extension/STL_Extension.txt @@ -4,7 +4,7 @@ namespace CGAL { \mainpage STL Extensions for %CGAL \anchor Chapter_STL_Extensions_for_CGAL -\anchor chapterStlExtensions + \autotoc \authors Michael Hoffmann, Lutz Kettner, Sylvain Pion, and Ron Wein diff --git a/Spatial_sorting/doc/Spatial_sorting/CGAL/Hilbert_sort_2.h b/Spatial_sorting/doc/Spatial_sorting/CGAL/Hilbert_sort_2.h index 401722b9b1a..8cc3f1116dc 100644 --- a/Spatial_sorting/doc/Spatial_sorting/CGAL/Hilbert_sort_2.h +++ b/Spatial_sorting/doc/Spatial_sorting/CGAL/Hilbert_sort_2.h @@ -32,7 +32,7 @@ Hilbert_sort_2(const Traits &traits = Traits()); /*! sorts the range [`begin`, `end`). -\require `RandomAccessIterator::value_type` equals to `Traits::Point_2`. +\requires `RandomAccessIterator::value_type` equals to `Traits::Point_2`. */ template void operator() (RandomAccessIterator begin, RandomAccessIterator end) const; diff --git a/Spatial_sorting/doc/Spatial_sorting/CGAL/Hilbert_sort_3.h b/Spatial_sorting/doc/Spatial_sorting/CGAL/Hilbert_sort_3.h index 9c7e66663ae..62004a53417 100644 --- a/Spatial_sorting/doc/Spatial_sorting/CGAL/Hilbert_sort_3.h +++ b/Spatial_sorting/doc/Spatial_sorting/CGAL/Hilbert_sort_3.h @@ -31,7 +31,7 @@ Hilbert_sort_3(const Traits &traits = Traits()); /*! sorts the range [`begin`, `end`). -\require `RandomAccessIterator::value_type` equals to `Traits::Point_3`. +\requires `RandomAccessIterator::value_type` equals to `Traits::Point_3`. */ template void operator() (RandomAccessIterator begin, RandomAccessIterator end) const; diff --git a/Spatial_sorting/doc/Spatial_sorting/CGAL/Hilbert_sort_d.h b/Spatial_sorting/doc/Spatial_sorting/CGAL/Hilbert_sort_d.h index 01d3f595c95..d04bad53b04 100644 --- a/Spatial_sorting/doc/Spatial_sorting/CGAL/Hilbert_sort_d.h +++ b/Spatial_sorting/doc/Spatial_sorting/CGAL/Hilbert_sort_d.h @@ -31,7 +31,7 @@ Hilbert_sort_d(const Traits &traits = Traits()); /*! sorts the range [`begin`, `end`). -\require `RandomAccessIterator::value_type` equals to `Traits::Point_d`. +\requires `RandomAccessIterator::value_type` equals to `Traits::Point_d`. */ template void operator() (RandomAccessIterator begin, RandomAccessIterator end) const; diff --git a/Spatial_sorting/doc/Spatial_sorting/CGAL/Multiscale_sort.h b/Spatial_sorting/doc/Spatial_sorting/CGAL/Multiscale_sort.h index 907596b3ada..389191107c3 100644 --- a/Spatial_sorting/doc/Spatial_sorting/CGAL/Multiscale_sort.h +++ b/Spatial_sorting/doc/Spatial_sorting/CGAL/Multiscale_sort.h @@ -31,7 +31,7 @@ Multiscale_sort (const Sort &sort = Sort(), std::ptrdiff_t threshold = 1, double /*! sorts the range [`begin`, `end`). -\require `Sort::operator()(RandomAccessIterator begin, RandomAccessIterator end)` is defined. +\requires `Sort::operator()(RandomAccessIterator begin, RandomAccessIterator end)` is defined. */ template void operator() (RandomAccessIterator begin, RandomAccessIterator end) const;