$include_dir="/home/hyper-archives/boost-commit/include"; include("$include_dir/msg-header.inc") ?>
Subject: [Boost-commit] svn:boost r71324 - in trunk/libs/geometry/doc: . doxy reference/core src/examples/algorithms src/examples/core
From: barend.gehrels_at_[hidden]
Date: 2011-04-16 13:58:37
Author: barendgehrels
Date: 2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
New Revision: 71324
URL: http://svn.boost.org/trac/boost/changeset/71324
Log:
Doc update (metafunctions coordinate type, system, dimensions, point_order, closure, tags degree/radian, constans min_corner, max_corner)
Added:
   trunk/libs/geometry/doc/reference/core/closure.qbk   (contents, props changed)
   trunk/libs/geometry/doc/reference/core/coordinate_dimension.qbk   (contents, props changed)
   trunk/libs/geometry/doc/reference/core/coordinate_system.qbk   (contents, props changed)
   trunk/libs/geometry/doc/reference/core/coordinate_type.qbk   (contents, props changed)
   trunk/libs/geometry/doc/reference/core/degree_radian.qbk   (contents, props changed)
   trunk/libs/geometry/doc/reference/core/max_corner.qbk   (contents, props changed)
   trunk/libs/geometry/doc/reference/core/min_corner.qbk   (contents, props changed)
   trunk/libs/geometry/doc/reference/core/min_max_corner.qbk   (contents, props changed)
   trunk/libs/geometry/doc/reference/core/point_order.qbk   (contents, props changed)
   trunk/libs/geometry/doc/src/examples/core/closure.cpp   (contents, props changed)
   trunk/libs/geometry/doc/src/examples/core/coordinate_dimension.cpp   (contents, props changed)
   trunk/libs/geometry/doc/src/examples/core/coordinate_system.cpp   (contents, props changed)
   trunk/libs/geometry/doc/src/examples/core/coordinate_type.cpp   (contents, props changed)
   trunk/libs/geometry/doc/src/examples/core/degree_radian.cpp   (contents, props changed)
   trunk/libs/geometry/doc/src/examples/core/point_order.cpp   (contents, props changed)
Text files modified: 
   trunk/libs/geometry/doc/doxy/Doxyfile                       |     3 +++                                     
   trunk/libs/geometry/doc/imports.qbk                         |     8 ++++++++                                
   trunk/libs/geometry/doc/make_qbk.py                         |     3 ++-                                     
   trunk/libs/geometry/doc/quickref.xml                        |    13 ++++---------                           
   trunk/libs/geometry/doc/reference.qbk                       |    16 +++++++---------                        
   trunk/libs/geometry/doc/src/examples/algorithms/convert.cpp |     2 +-                                      
   trunk/libs/geometry/doc/src/examples/core/Jamfile.v2        |     7 +++++++                                 
   7 files changed, 32 insertions(+), 20 deletions(-)
Modified: trunk/libs/geometry/doc/doxy/Doxyfile
==============================================================================
--- trunk/libs/geometry/doc/doxy/Doxyfile	(original)
+++ trunk/libs/geometry/doc/doxy/Doxyfile	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -50,6 +50,7 @@
                         brief_macro{1}="Macro to register a \1" \
                         brief_macro_const=" (const version)" \
                         brief_macro_getset=" (having separate get/set methods)" \
+            brief_meta{3}="Metafunction defining [*\1] as the specified \2 of the \3" \
                         tparam_allocator="container-allocator-type" \
                         tparam_box="Any type fulfilling a Box Concept" \
                         tparam_box_or_segment="Any type fulfilling a Box Concept or a Segment Concept" \
@@ -107,6 +108,8 @@
                         return_check{1}="Returns true if the geometry \1" \
                         return_check2{1}="Returns true if two geometries \1" \
                         return_out="The output iterator" \
+            meta_geometry_type="specified geometry type" \
+            meta_point_type="point type making up the specified geometry type" \
                         brf_for_each{1}="Applies function [*f] to each \1" \ 
                         det_envelope="envelope (also known as axis aligned bounding box, aabb, or minimum bounding rectangle, mbr)" \
                         det_buffer="buffer (a polygon being the spatial point set collection within a specified maximum distance from a geometry)" \
Modified: trunk/libs/geometry/doc/imports.qbk
==============================================================================
--- trunk/libs/geometry/doc/imports.qbk	(original)
+++ trunk/libs/geometry/doc/imports.qbk	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -57,9 +57,17 @@
 [import src/examples/algorithms/unique.cpp]
 [import src/examples/algorithms/within.cpp]
 
+[import src/examples/core/coordinate_type.cpp]
+[import src/examples/core/coordinate_system.cpp]
+[import src/examples/core/coordinate_dimension.cpp]
+[import src/examples/core/point_order.cpp]
+[import src/examples/core/closure.cpp]
+
 [import src/examples/core/get_point.cpp]
 [import src/examples/core/get_box.cpp]
 [import src/examples/core/set_point.cpp]
 [import src/examples/core/set_box.cpp]
+[import src/examples/core/degree_radian.cpp]
+
 [import src/examples/geometries/point.cpp]
 [import src/examples/geometries/register/point.cpp]
Modified: trunk/libs/geometry/doc/make_qbk.py
==============================================================================
--- trunk/libs/geometry/doc/make_qbk.py	(original)
+++ trunk/libs/geometry/doc/make_qbk.py	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -82,7 +82,8 @@
 
 core = ["closure", "coordinate_system", "coordinate_type", "cs_tag"
     , "dimension", "exception", "geometry_id", "interior_type"
-    , "is_areal", "is_linear", "is_radian", "point_order"
+    , "degree", "radian"
+    , "is_radian", "point_order"
     , "point_type", "ring_type", "tag", "topological_dimension" ]
 
 exceptions = ["exception", "centroid_exception"];
Modified: trunk/libs/geometry/doc/quickref.xml
==============================================================================
--- trunk/libs/geometry/doc/quickref.xml	(original)
+++ trunk/libs/geometry/doc/quickref.xml	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -138,16 +138,11 @@
      <member><link linkend="geometry.reference.core.dimension">dimension</link></member>
      <member><link linkend="geometry.reference.core.geometry_id">geometry_id</link></member>
      <member><link linkend="geometry.reference.core.interior_type">interior_type</link></member>
-     <!-- will be replaced by tag inheritance
-     <member><link linkend="geometry.reference.core.is_linear">is_linear</link></member>
-     <member><link linkend="geometry.reference.core.is_multi">is_multi</link></member>
-     -->
      <member><link linkend="geometry.reference.core.is_radian">is_radian</link></member>
      <member><link linkend="geometry.reference.core.point_order">point_order</link></member>
      <member><link linkend="geometry.reference.core.point_type">point_type</link></member>
      <member><link linkend="geometry.reference.core.ring_type">ring_type</link></member>
      <!-- for internal use only (detail?)
-     <member><link linkend="geometry.reference.core.replace_point_type">replace_point_type</link></member>
      <member><link linkend="geometry.reference.core.reverse_dispatch">reverse_dispatch</link></member>
      -->
      <member><link linkend="geometry.reference.core.tag">tag</link></member>
@@ -194,8 +189,8 @@
    <entry valign="top">
     <bridgehead renderas="sect3">Numeric</bridgehead>
     <simplelist type="vert" columns="1">
-    <member><link linkend="geometry.reference.max_corner">max_corner</link></member>
-    <member><link linkend="geometry.reference.min_corner">min_corner</link></member>
+    <member><link linkend="geometry.reference.constants.max_corner">max_corner</link></member>
+    <member><link linkend="geometry.reference.constants.min_corner">min_corner</link></member>
     <member><link linkend="geometry.reference.enumerations.order_selector">order_selector</link></member>
     <member><link linkend="geometry.reference.enumerations.closure_selector">closure_selector</link></member>
     </simplelist>
@@ -203,8 +198,8 @@
    <entry valign="top">
     <bridgehead renderas="sect3">Types</bridgehead>
     <simplelist type="vert" columns="1">
-    <member><link linkend="geometry.reference.degree">degree</link></member>
-    <member><link linkend="geometry.reference.radian">radian</link></member>
+    <member><link linkend="geometry.reference.core.degree">degree</link></member>
+    <member><link linkend="geometry.reference.core.radian">radian</link></member>
     </simplelist>
    </entry>
    <entry valign="top">
Modified: trunk/libs/geometry/doc/reference.qbk
==============================================================================
--- trunk/libs/geometry/doc/reference.qbk	(original)
+++ trunk/libs/geometry/doc/reference.qbk	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -129,7 +129,6 @@
 [include generated/transform.qbk]
 [endsect]
 
-
 [/section:union union]
 [include generated/union.qbk]
 [/endsect]
@@ -142,13 +141,10 @@
 
 [endsect] [/algorithms]
 
-
 [section:arithmetic Arithmetic]
 [include generated/arithmetic.qbk]
 [endsect] 
 
-
-
 [section:concepts Concepts]
 [include concept/point.qbk]
 [include concept/linestring.qbk]
@@ -161,34 +157,36 @@
 [include concept/segment.qbk]
 [endsect] [/concepts]
 
+[section:constants Constants]
+[include reference/core/min_corner.qbk]
+[include reference/core/max_corner.qbk]
+[endsect] 
+
 [section:cs Coordinate Systems]
 [include generated/cartesian.qbk]
 [include generated/spherical.qbk]
 [include generated/geographic.qbk]
 [endsect] [/coordinate systems]
 
-
-
 [section:core Core Metafunctions]
 [include generated/closure.qbk]
 [include generated/coordinate_system.qbk]
 [include generated/coordinate_type.qbk]
 [include generated/cs_tag.qbk]
+[include generated/degree.qbk]
 [include generated/dimension.qbk]
 [include generated/exception.qbk]
 [include generated/geometry_id.qbk]
 [include generated/interior_type.qbk]
-[include generated/is_areal.qbk]
-[include generated/is_linear.qbk]
 [include generated/is_radian.qbk]
 [include generated/point_order.qbk]
 [include generated/point_type.qbk]
+[include generated/radian.qbk]
 [include generated/ring_type.qbk]
 [include generated/tag.qbk]
 [include generated/topological_dimension.qbk]
 [endsect] [/core metafunctions]
 
-
 [section:enumerations Enumerations]
 [include generated/enum.qbk]
 [endsect] 
Added: trunk/libs/geometry/doc/reference/core/closure.qbk
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/reference/core/closure.qbk	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,23 @@
+[/============================================================================
+  Boost.Geometry (aka GGL, Generic Geometry Library)
+
+  Copyright (c) 2009-2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+  Use, modification and distribution is subject to the Boost Software License,
+  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+  http://www.boost.org/LICENSE_1_0.txt)
+=============================================================================/]
+
+[note The closure is defined for any geometry type, but only has a real meaning
+  for areal geometry types (ring, polygon, multi_polygon)
+]  
+
+[heading Complexity]
+Compile time
+
+[heading Example]
+[closure]
+[closure_output]
+
+[heading See also]
+* [link geometry.reference.enumerations.closure_selector The closure_selector enumeration]
Added: trunk/libs/geometry/doc/reference/core/coordinate_dimension.qbk
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/reference/core/coordinate_dimension.qbk	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,16 @@
+[/============================================================================
+  Boost.Geometry (aka GGL, Generic Geometry Library)
+
+  Copyright (c) 2009-2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+  Use, modification and distribution is subject to the Boost Software License,
+  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+  http://www.boost.org/LICENSE_1_0.txt)
+=============================================================================/]
+
+[heading Complexity]
+Compile time
+
+[heading Example]
+[dimension]
+[dimension_output]
Added: trunk/libs/geometry/doc/reference/core/coordinate_system.qbk
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/reference/core/coordinate_system.qbk	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,16 @@
+[/============================================================================
+  Boost.Geometry (aka GGL, Generic Geometry Library)
+
+  Copyright (c) 2009-2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+  Use, modification and distribution is subject to the Boost Software License,
+  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+  http://www.boost.org/LICENSE_1_0.txt)
+=============================================================================/]
+
+[heading Complexity]
+Compile time
+
+[heading Example]
+[coordinate_system]
+[coordinate_system_output]
Added: trunk/libs/geometry/doc/reference/core/coordinate_type.qbk
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/reference/core/coordinate_type.qbk	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,16 @@
+[/============================================================================
+  Boost.Geometry (aka GGL, Generic Geometry Library)
+
+  Copyright (c) 2009-2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+  Use, modification and distribution is subject to the Boost Software License,
+  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+  http://www.boost.org/LICENSE_1_0.txt)
+=============================================================================/]
+
+[heading Complexity]
+Compile time
+
+[heading Example]
+[coordinate_type]
+[coordinate_type_output]
Added: trunk/libs/geometry/doc/reference/core/degree_radian.qbk
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/reference/core/degree_radian.qbk	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,14 @@
+[/============================================================================
+  Boost.Geometry (aka GGL, Generic Geometry Library)
+
+  Copyright (c) 2009-2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+  Use, modification and distribution is subject to the Boost Software License,
+  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+  http://www.boost.org/LICENSE_1_0.txt)
+=============================================================================/]
+
+
+[heading example]
+[degree_radian]
+[degree_radian_output]
\ No newline at end of file
Added: trunk/libs/geometry/doc/reference/core/max_corner.qbk
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/reference/core/max_corner.qbk	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,26 @@
+[/============================================================================
+  Boost.Geometry (aka GGL, Generic Geometry Library)
+
+  Copyright (c) 2009-2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+  Use, modification and distribution is subject to the Boost Software License,
+  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+  http://www.boost.org/LICENSE_1_0.txt)
+=============================================================================/]
+
+[section:max_corner max_corner]
+
+Indicates the maximal corner (upper right) of a box to be get, set or processed
+
+[heading Synopsis]
+`` int const max_corner = 1; ``
+
+[include reference/core/min_max_corner.qbk]
+
+[heading See also]
+* [link geometry.reference.constants.min_corner min_corner]
+* [link geometry.reference.access.get.get_2_with_index get with index]
+* [link geometry.reference.access.set.set_3_with_index set with index]
+
+[endsect]
+
Added: trunk/libs/geometry/doc/reference/core/min_corner.qbk
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/reference/core/min_corner.qbk	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,25 @@
+[/============================================================================
+  Boost.Geometry (aka GGL, Generic Geometry Library)
+
+  Copyright (c) 2009-2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+  Use, modification and distribution is subject to the Boost Software License,
+  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+  http://www.boost.org/LICENSE_1_0.txt)
+=============================================================================/]
+
+[section:min_corner min_corner]
+
+Indicates the minimal corner (lower left) of a box to be get, set or processed
+
+[heading Synopsis]
+`` int const min_corner = 0; ``
+
+[include reference/core/min_max_corner.qbk]
+
+[heading See also]
+* [link geometry.reference.constants.max_corner max_corner]
+* [link geometry.reference.access.get.get_2_with_index get with index]
+* [link geometry.reference.access.set.set_3_with_index set with index]
+
+[endsect]
Added: trunk/libs/geometry/doc/reference/core/min_max_corner.qbk
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/reference/core/min_max_corner.qbk	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,31 @@
+[/============================================================================
+  Boost.Geometry (aka GGL, Generic Geometry Library)
+
+  Copyright (c) 2009-2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+  Use, modification and distribution is subject to the Boost Software License,
+  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+  http://www.boost.org/LICENSE_1_0.txt)
+=============================================================================/]
+
+[/File included by min_corner.qbk and max_corner.qbk]
+
+[heading Header]
+Either
+
+`#include <boost/geometry/geometry.hpp>`
+
+Or
+
+`#include <boost/geometry/core/access.hpp>`
+
+[note min_corner and max_corner are only applicable for boxes and not for, 
+    e.g., a segment]
+[note min_corner should be the minimal corner of a box, but that is not 
+    guaranteed. Use correct to make min_corner the minimal corner.
+    The same applies for max_corner.]
+
+[/Share sample with get_box]
+[heading Example]
+[get_box]
+[get_box_output]
Added: trunk/libs/geometry/doc/reference/core/point_order.qbk
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/reference/core/point_order.qbk	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,24 @@
+[/============================================================================
+  Boost.Geometry (aka GGL, Generic Geometry Library)
+
+  Copyright (c) 2009-2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+  Use, modification and distribution is subject to the Boost Software License,
+  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+  http://www.boost.org/LICENSE_1_0.txt)
+=============================================================================/]
+
+[note The point order is defined for any geometry type, but only has a real meaning
+  for areal geometry types (ring, polygon, multi_polygon)
+]
+
+[heading Complexity]
+Compile time
+
+[heading Example]
+[point_order]
+[point_order_output]
+
+[heading See also]
+* [link geometry.reference.enumerations.order_selector The order_selector enumeration]
+
Modified: trunk/libs/geometry/doc/src/examples/algorithms/convert.cpp
==============================================================================
--- trunk/libs/geometry/doc/src/examples/algorithms/convert.cpp	(original)
+++ trunk/libs/geometry/doc/src/examples/algorithms/convert.cpp	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -12,7 +12,7 @@
 
 #include <iostream>
 
-#include <boost/geometry/geometry.hpp>
+#include <boost/geometry.hpp>
 #include <boost/geometry/geometries/adapted/tuple_cartesian.hpp>
 
 int main()
Modified: trunk/libs/geometry/doc/src/examples/core/Jamfile.v2
==============================================================================
--- trunk/libs/geometry/doc/src/examples/core/Jamfile.v2	(original)
+++ trunk/libs/geometry/doc/src/examples/core/Jamfile.v2	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -17,3 +17,10 @@
 exe get_box : get_box.cpp ;
 exe set_point : set_point.cpp ;
 exe set_box : set_box.cpp ;
+exe degree_radian : degree_radian.cpp ;
+
+exe coordinate_type : coordinate_type.cpp ;
+exe coordinate_system : coordinate_system.cpp ;
+exe coordinate_dimension : coordinate_dimension.cpp ;
+exe point_order : point_order.cpp ;
+exe closure : closure.cpp ;
Added: trunk/libs/geometry/doc/src/examples/core/closure.cpp
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/src/examples/core/closure.cpp	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,42 @@
+// Boost.Geometry (aka GGL, Generic Geometry Library)
+// QuickBook Example
+
+// Copyright (c) 2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+// Use, modification and distribution is subject to the Boost Software License,
+// Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+// http://www.boost.org/LICENSE_1_0.txt)
+
+//[closure
+//` Examine if a polygon is defined as "should be closed"
+
+#include <iostream>
+#include <boost/geometry/geometry.hpp>
+
+int main()
+{
+    typedef boost::geometry::model::d2::point_xy<double> point_type;
+    typedef boost::geometry::model::polygon<point_type> polygon_type;
+
+    boost::geometry::closure_selector clos = boost::geometry::closure<polygon_type>::value;
+    
+    std::cout << "closure: " << clos << std::endl
+        << "(open = " << boost::geometry::open
+        << ", closed = " << boost::geometry::closed 
+        << ") "<< std::endl;
+
+    return 0;
+}
+
+//]
+
+
+//[closure_output
+/*`
+Output:
+[pre
+closure: 1
+(open = 0, closed = 1)
+]
+*/
+//]
Added: trunk/libs/geometry/doc/src/examples/core/coordinate_dimension.cpp
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/src/examples/core/coordinate_dimension.cpp	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,43 @@
+// Boost.Geometry (aka GGL, Generic Geometry Library)
+// QuickBook Example
+
+// Copyright (c) 2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+// Use, modification and distribution is subject to the Boost Software License,
+// Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+// http://www.boost.org/LICENSE_1_0.txt)
+
+//[dimension
+//` Examine the number of coordinates making up the points in a linestring type
+
+#include <iostream>
+#include <boost/geometry/geometry.hpp>
+#include <boost/geometry/geometries/adapted/tuple_cartesian.hpp>
+#include <boost/geometry/geometries/adapted/std_as_linestring.hpp>
+
+int main()
+{
+    int dim = boost::geometry::dimension
+        <
+            std::vector
+                <
+                    boost::tuple<float, float, float>
+                >
+        >::value;
+    
+    std::cout << "dimensions: " << dim << std::endl;
+
+    return 0;
+}
+
+//]
+
+
+//[dimension_output
+/*`
+Output:
+[pre
+dimensions: 3
+]
+*/
+//]
Added: trunk/libs/geometry/doc/src/examples/core/coordinate_system.cpp
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/src/examples/core/coordinate_system.cpp	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,38 @@
+// Boost.Geometry (aka GGL, Generic Geometry Library)
+// QuickBook Example
+
+// Copyright (c) 2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+// Use, modification and distribution is subject to the Boost Software License,
+// Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+// http://www.boost.org/LICENSE_1_0.txt)
+
+//[coordinate_system
+//` Examine the coordinate system of a point
+
+#include <iostream>
+#include <boost/geometry/geometry.hpp>
+
+int main()
+{
+    typedef boost::geometry::model::d2::point_xy<double> point_type;
+    typedef boost::geometry::model::polygon<point_type> polygon_type;
+
+    typedef boost::geometry::coordinate_system<polygon_type>::type system;
+    
+    std::cout << "system: " << typeid(system).name() << std::endl;
+
+    return 0;
+}
+
+//]
+
+
+//[coordinate_system_output
+/*`
+Output (using MSVC):
+[pre
+system: struct boost::geometry::cs::cartesian
+]
+*/
+//]
Added: trunk/libs/geometry/doc/src/examples/core/coordinate_type.cpp
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/src/examples/core/coordinate_type.cpp	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,38 @@
+// Boost.Geometry (aka GGL, Generic Geometry Library)
+// QuickBook Example
+
+// Copyright (c) 2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+// Use, modification and distribution is subject to the Boost Software License,
+// Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+// http://www.boost.org/LICENSE_1_0.txt)
+
+//[coordinate_type
+//` Examine the coordinate type of a point
+
+#include <iostream>
+#include <boost/geometry/geometry.hpp>
+
+int main()
+{
+    typedef boost::geometry::model::d2::point_xy<double> point_type;
+    typedef boost::geometry::model::polygon<point_type> polygon_type;
+
+    typedef boost::geometry::coordinate_type<polygon_type>::type ctype;
+    
+    std::cout << "type: " << typeid(ctype).name() << std::endl;
+
+    return 0;
+}
+
+//]
+
+
+//[coordinate_type_output
+/*`
+Output (using MSVC):
+[pre
+type: double
+]
+*/
+//]
Added: trunk/libs/geometry/doc/src/examples/core/degree_radian.cpp
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/src/examples/core/degree_radian.cpp	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,47 @@
+// Boost.Geometry (aka GGL, Generic Geometry Library)
+// QuickBook Example
+
+// Copyright (c) 2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+// Use, modification and distribution is subject to the Boost Software License,
+// Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+// http://www.boost.org/LICENSE_1_0.txt)
+
+//[degree_radian
+//` Specify two coordinate systems, one in degrees, one in radians.
+
+#include <iostream>
+#include <boost/geometry/geometry.hpp>
+
+using namespace boost::geometry;
+
+int main()
+{
+    typedef model::point<double, 2, cs::spherical<degree> > degree_point;
+    typedef model::point<double, 2, cs::spherical<radian> > radian_point;
+    
+    degree_point d(4.893, 52.373);
+    radian_point r(0.041, 0.8527);
+
+    double dist = distance(d, r);
+    std::cout 
+        << "distance:" << std::endl
+        << dist << " over unit sphere" << std::endl
+        << dist * 3959  << " over a spherical earth, in miles" << std::endl;
+
+    return 0;
+}
+
+//]
+
+
+//[degree_radian_output
+/*`
+Output:
+[pre
+distance:
+0.0675272 over unit sphere
+267.34 over a spherical earth, in miles
+]
+*/
+//]
Added: trunk/libs/geometry/doc/src/examples/core/point_order.cpp
==============================================================================
--- (empty file)
+++ trunk/libs/geometry/doc/src/examples/core/point_order.cpp	2011-04-16 13:58:34 EDT (Sat, 16 Apr 2011)
@@ -0,0 +1,42 @@
+// Boost.Geometry (aka GGL, Generic Geometry Library)
+// QuickBook Example
+
+// Copyright (c) 2011 Barend Gehrels, Amsterdam, the Netherlands.
+
+// Use, modification and distribution is subject to the Boost Software License,
+// Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
+// http://www.boost.org/LICENSE_1_0.txt)
+
+//[point_order
+//` Examine the expected point order of a polygon type
+
+#include <iostream>
+#include <boost/geometry/geometry.hpp>
+
+int main()
+{
+    typedef boost::geometry::model::d2::point_xy<double> point_type;
+    typedef boost::geometry::model::polygon<point_type, false> polygon_type;
+
+    boost::geometry::order_selector order = boost::geometry::point_order<polygon_type>::value;
+    
+    std::cout << "order: " << order << std::endl
+        << "(clockwise = " << boost::geometry::clockwise
+        << ", counterclockwise = " << boost::geometry::counterclockwise
+        << ") "<< std::endl;
+
+    return 0;
+}
+
+//]
+
+
+//[point_order_output
+/*`
+Output:
+[pre
+order: 2
+(clockwise = 1, counterclockwise = 2)
+]
+*/
+//]