Added and updated documentation of correct, transform, distance, comparable_distance

[SVN r71153]

doc/src/examples/algorithms/transform.cpp

@@ -0,0 +1,53 @@
+// 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)
+
+//[transform
+//` Shows how points can be transformed using the default strategy
+
+#include <iostream>
+#include <boost/geometry/geometry.hpp>
+
+
+int main()
+{
+    namespace bg = boost::geometry;
+
+    bg::model::point<long double, 2, bg::cs::spherical<bg::degree> > p1(5.0, 52.0);
+    
+    // Transform from degree to radian. Default strategy is automatically selected,
+    // it will convert from degree to radian
+    bg::model::point<long double, 2, bg::cs::spherical<bg::radian> > p2;
+    bg::transform(p1, p2);
+    
+    // Transform from degree (lon-lat) to 3D (x,y,z). Default strategy is automatically selected, 
+    // it will consider points on a unit sphere
+    bg::model::point<long double, 3, bg::cs::cartesian> p3;
+    bg::transform(p1, p3);
+    
+    std::cout 
+        << "p1: " << bg::dsv(p1) << std::endl
+        << "p2: " << bg::dsv(p2) << std::endl
+        << "p3: " << bg::dsv(p3) << std::endl;
+
+    return 0;
+}
+
+//]
+
+
+//[transform_output
+/*`
+Output:
+[pre
+p1: (5, 52)
+p2: (0.0872665, 0.907571)
+p3: (0.785012, 0.0686797, 0.615661)
+]
+*/
+//]