diff --git a/include/boost/geometry/index/predicates.hpp b/include/boost/geometry/index/predicates.hpp index f4e22bdd5..a79e3f173 100644 --- a/include/boost/geometry/index/predicates.hpp +++ b/include/boost/geometry/index/predicates.hpp @@ -2,7 +2,7 @@ // // Spatial query predicates // -// Copyright (c) 2011-2015 Adam Wulkiewicz, Lodz, Poland. +// Copyright (c) 2011-2018 Adam Wulkiewicz, Lodz, Poland. // // Use, modification and distribution is subject to the Boost Software License, // Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at @@ -23,9 +23,10 @@ namespace boost { namespace geometry { namespace index { /*! \brief Generate \c contains() predicate. -Generate a predicate defining Value and Geometry relationship. -Value will be returned by the query if bg::within(Geometry, Indexable) -returns true. +Generate a predicate defining Value and Geometry relationship. With this +predicate query returns indexed Values that contain passed Geometry. +Value is returned by the query if bg::within(Geometry, Indexable) +returns true. \par Example \verbatim @@ -53,9 +54,10 @@ contains(Geometry const& g) /*! \brief Generate \c covered_by() predicate. -Generate a predicate defining Value and Geometry relationship. -Value will be returned by the query if bg::covered_by(Indexable, Geometry) -returns true. +Generate a predicate defining Value and Geometry relationship. With this +predicate query returns indexed Values that are covered by passed Geometry. +Value is returned by the query if bg::covered_by(Indexable, Geometry) +returns true. \par Example \verbatim @@ -83,9 +85,10 @@ covered_by(Geometry const& g) /*! \brief Generate \c covers() predicate. -Generate a predicate defining Value and Geometry relationship. -Value will be returned by the query if bg::covered_by(Geometry, Indexable) -returns true. +Generate a predicate defining Value and Geometry relationship. With this +predicate query returns indexed Values that cover passed Geometry. +Value is returned by the query if bg::covered_by(Geometry, Indexable) +returns true. \par Example \verbatim @@ -113,9 +116,10 @@ covers(Geometry const& g) /*! \brief Generate \c disjoint() predicate. -Generate a predicate defining Value and Geometry relationship. -Value will be returned by the query if bg::disjoint(Indexable, Geometry) -returns true. +Generate a predicate defining Value and Geometry relationship. With this +predicate query returns indexed Values that are disjoint with passed Geometry. +Value is returned by the query if bg::disjoint(Indexable, Geometry) +returns true. \par Example \verbatim @@ -143,9 +147,10 @@ disjoint(Geometry const& g) /*! \brief Generate \c intersects() predicate. -Generate a predicate defining Value and Geometry relationship. -Value will be returned by the query if bg::intersects(Indexable, Geometry) -returns true. +Generate a predicate defining Value and Geometry relationship. With this +predicate query returns indexed Values that intersect passed Geometry. +Value is returned by the query if bg::intersects(Indexable, Geometry) +returns true. \par Example \verbatim @@ -175,9 +180,10 @@ intersects(Geometry const& g) /*! \brief Generate \c overlaps() predicate. -Generate a predicate defining Value and Geometry relationship. -Value will be returned by the query if bg::overlaps(Indexable, Geometry) -returns true. +Generate a predicate defining Value and Geometry relationship. With this +predicate query returns indexed Values that overlap passed Geometry. +Value is returned by the query if bg::overlaps(Indexable, Geometry) +returns true. \par Example \verbatim @@ -207,9 +213,10 @@ overlaps(Geometry const& g) /*! \brief Generate \c touches() predicate. -Generate a predicate defining Value and Geometry relationship. -Value will be returned by the query if bg::touches(Indexable, Geometry) -returns true. +Generate a predicate defining Value and Geometry relationship. With this +predicate query returns indexed Values that touch passed Geometry. +Value is returned by the query if bg::touches(Indexable, Geometry) +returns true. \ingroup predicates @@ -234,9 +241,10 @@ touches(Geometry const& g) /*! \brief Generate \c within() predicate. -Generate a predicate defining Value and Geometry relationship. -Value will be returned by the query if bg::within(Indexable, Geometry) -returns true. +Generate a predicate defining Value and Geometry relationship. With this +predicate query returns indexed Values that are within passed Geometry. +Value is returned by the query if bg::within(Indexable, Geometry) +returns true. \par Example \verbatim