Boost logo

Boost-Commit :

Subject: [Boost-commit] svn:boost r68682 - trunk/boost/geometry/core
From: barend.gehrels_at_[hidden]
Date: 2011-02-06 16:09:59


Author: barendgehrels
Date: 2011-02-06 16:09:58 EST (Sun, 06 Feb 2011)
New Revision: 68682
URL: http://svn.boost.org/trac/boost/changeset/68682

Log:
get/set update for doc
Text files modified:
   trunk/boost/geometry/core/access.hpp | 110 ++++++++++++++++++++++-----------------
   1 files changed, 61 insertions(+), 49 deletions(-)

Modified: trunk/boost/geometry/core/access.hpp
==============================================================================
--- trunk/boost/geometry/core/access.hpp (original)
+++ trunk/boost/geometry/core/access.hpp 2011-02-06 16:09:58 EST (Sun, 06 Feb 2011)
@@ -33,15 +33,17 @@
 namespace traits
 {
 
-/// @brief Traits class which gives access (get,set) to points.
-/// @ingroup traits
-/// @par Geometries:
+/*!
+\brief Traits class which gives access (get,set) to points.
+\ingroup traits
+\par Geometries:
 /// @li point
-/// @par Specializations should provide, per Dimension
+\par Specializations should provide, per Dimension
 /// @li static inline T get(G const&)
 /// @li static inline void set(G&, T const&)
-/// @tparam Geometry geometry-type
-/// @tparam Dimension dimension to access
+\tparam Geometry geometry-type
+\tparam Dimension dimension to access
+*/
 template <typename Geometry, std::size_t Dimension, typename Enable = void>
 struct access
 {
@@ -174,19 +176,20 @@
 #endif // DOXYGEN_NO_DETAIL
 
 
-// Note the comments below tell Doxygen to create one function with doc for both
-
-/// @brief get coordinate value of a Point ( / Sphere)
-/// @ingroup get
-/// @tparam Dimension dimension
-/// @tparam Geometry geometry
-/// @param geometry geometry to query coordinate value from
-/// @return coordinate value
+/*!
+\brief Get coordinate value of a geometry (usually a point)
+\details \details_get_set
+\ingroup get
+\tparam Dimension \tparam_dimension_required
+\tparam Geometry \tparam_geometry (usually a Point Concept)
+\param geometry \param_geometry (usually a point)
+\param dummy \qbk_skip
+\return The coordinate value of specified dimension of specified geometry
+\qbk{[include ref/core/get_point.qbk]}
+*/
 template <std::size_t Dimension, typename Geometry>
 inline typename coordinate_type<Geometry>::type get(Geometry const& geometry
-#ifndef DOXYGEN_SHOULD_SKIP_THIS
         , detail::signature_getset_dimension* dummy = 0
-#endif
         )
 {
     boost::ignore_unused_variable_warning(dummy);
@@ -205,18 +208,23 @@
 }
 
 
-/// @brief set coordinate value of a Point ( / Sphere)
-/// @tparam Dimension dimension
-/// @tparam Geometry geometry
-/// @param geometry geometry to assign coordinate to
-/// @param value coordinate value to assign
-/// @ingroup set
+/*!
+\brief Set coordinate value of a geometry (usually a point)
+\details \details_get_set
+\tparam Dimension \tparam_dimension_required
+\tparam Geometry \tparam_geometry (usually a Point Concept)
+\param geometry geometry to assign coordinate to
+\param geometry \param_geometry (usually a point)
+\param value The coordinate value to set
+\param dummy \qbk_skip
+\ingroup set
+
+\qbk{[include ref/core/set_point.qbk]}
+*/
 template <std::size_t Dimension, typename Geometry>
 inline void set(Geometry& geometry
         , typename coordinate_type<Geometry>::type const& value
-#ifndef DOXYGEN_SHOULD_SKIP_THIS
         , detail::signature_getset_dimension* dummy = 0
-#endif
         )
 {
     boost::ignore_unused_variable_warning(dummy);
@@ -234,23 +242,24 @@
     coord_access_type::set(geometry, value);
 }
 
-// Note: doxygen needs a construct to distinguish get/set (like the gcc compiler)
 
-/// @brief get coordinate value of a Box / Segment
-/// @tparam Index
-/// - for Point: do not specify
-/// - for Box: min_corner or max_corner
-/// - for Segment: 0 / 1
-/// @tparam Dimension dimension
-/// @tparam Geometry geometry
-/// @param geometry geometry to query coordinate value from
-/// @return coordinate value
-/// @ingroup get
+/*!
+\brief get coordinate value of a Box or Segment
+\details \details_get_set
+\tparam Index \tparam_index_required
+\tparam Dimension \tparam_dimension_required
+\tparam Geometry \tparam_box_or_segment
+\param geometry \param_geometry
+\param dummy \qbk_skip
+\return coordinate value
+\ingroup get
+
+\qbk{distinguish,with index}
+\qbk{[include ref/core/get_box.qbk]}
+*/
 template <std::size_t Index, std::size_t Dimension, typename Geometry>
 inline typename coordinate_type<Geometry>::type get(Geometry const& geometry
-#ifndef DOXYGEN_SHOULD_SKIP_THIS
         , detail::signature_getset_index_dimension* dummy = 0
-#endif
         )
 {
     boost::ignore_unused_variable_warning(dummy);
@@ -269,22 +278,25 @@
     return coord_access_type::get(geometry);
 }
 
-/// @brief set coordinate value of a Box / Segment
-/// @tparam Index
-/// - for Point: do not specify
-/// - for Box: min_corner or max_corner
-/// - for Segment: 0 / 1
-/// @tparam Dimension dimension
-/// @tparam Geometry geometry
-/// @param geometry geometry to assign coordinate to
-/// @param value coordinate value to assign
-/// @ingroup set
+/*!
+\brief set coordinate value of a Box / Segment
+\details \details_get_set
+\tparam Index \tparam_index_required
+\tparam Dimension \tparam_dimension_required
+\tparam Geometry \tparam_box_or_segment
+\param geometry geometry to assign coordinate to
+\param geometry \param_geometry
+\param value The coordinate value to set
+\param dummy \qbk_skip
+\ingroup set
+
+\qbk{distinguish,with index}
+\qbk{[include ref/core/set_box.qbk]}
+*/
 template <std::size_t Index, std::size_t Dimension, typename Geometry>
 inline void set(Geometry& geometry
         , typename coordinate_type<Geometry>::type const& value
-#ifndef DOXYGEN_SHOULD_SKIP_THIS
         , detail::signature_getset_index_dimension* dummy = 0
-#endif
         )
 {
     boost::ignore_unused_variable_warning(dummy);


Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk