[gnome-devel-docs] new-platform-overview: Fix the Geographical information section

[Federico Mena Quintero <federico src gnome org>]

commit 01dd689ad3ed85b97322635750b365ba7e64161c
Author: Federico Mena Quintero <federico gnome org>
Date:   Tue Jun 18 14:22:00 2013 -0500

    new-platform-overview: Fix the Geographical information section
    
    Add back geocode-glib; fix the description of what geoclue2 does.
    
    Based on this blog post:  http://www.hadess.net/2013/04/geocluing-desktop-slowly.html

 new-platform-overview/tech-geoclue2.page     |   23 ++++++++++++---------
 new-platform-overview/tech-geocode-glib.page |   28 ++++++++++++++++++++++++++
 new-platform-overview/tech.page              |    4 +-
 3 files changed, 43 insertions(+), 12 deletions(-)
---
diff --git a/new-platform-overview/tech-geoclue2.page b/new-platform-overview/tech-geoclue2.page
index fb52576..dd7460f 100644
--- a/new-platform-overview/tech-geoclue2.page
+++ b/new-platform-overview/tech-geoclue2.page
@@ -3,25 +3,28 @@
       id="geoclue2">
 <info>
   <link type="guide" xref="tech" group="geoclue2"/>
-  <desc>Geocoding and reverse geocoding</desc>
+  <desc>Geolocation - finding the user's geographical location</desc>
 </info>
 
 <title>Geoclue2</title>
 
   <p>
-    Geoclue2 provides <em>geocoding</em> and <em>reverse geocoding</em>.
-    Geocoding is the process of translating an address ("123 High Street,
-    SomeTown, SomeCountry") to a pair of latitude/longitude values.  Reverse
-    geocoding is the opposite process.
+    Geoclue2 provides <em>geolocation</em> services, that is, it lets
+    applications find the user's geographical position.  A mapping
+    application could use this to present a "where am I" view, for
+    example.
   </p>
 
   <p>
-    Geoclue2 uses the Yahoo! Place Finder and GeoPlanet APIs internally to
-    do its work.
+    Geoclue2 intends to be able to provide positioning information
+    in several ways:  from the GPS in a WWAN modem, from a Wi-Fi
+    access point's data, or from the computer's IP address.
   </p>
 
-  <list style="compact">
-    <item><p><link href="http://developer.gnome.org/geoclue/unstable/";>Geoclue2 reference 
documentation</link></p></item>
-  </list>
+  <p>
+    Geoclue2 also intends to provide privacy for users who do not want
+    to reveal their geographical location.  Only applications allowed
+    by the user will be able to get geolocation information.
+  </p>
 
 </page>
diff --git a/new-platform-overview/tech-geocode-glib.page b/new-platform-overview/tech-geocode-glib.page
new file mode 100644
index 0000000..2883bed
--- /dev/null
+++ b/new-platform-overview/tech-geocode-glib.page
@@ -0,0 +1,28 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="geocode-glib">
+<info>
+  <link type="guide" xref="tech" group="geocode-glib"/>
+  <desc>Geocoding and reverse geocoding - conversion of street addresses to/from geographical 
coordinates</desc>
+</info>
+
+<title>Geocode-glib</title>
+
+  <p>
+    Geocode-glib provides <em>geocoding</em> and <em>reverse geocoding</em>.
+    Geocoding is the process of translating an address ("123 High Street,
+    SomeTown, SomeCountry") to a pair of latitude/longitude values.  Reverse
+    geocoding is the opposite process.
+  </p>
+
+  <p>
+    Geocode-glib uses the Yahoo! Place Finder API internally to
+    do its work.  In the future it will support the free Nominatim
+    service and OpenStreetMap data.
+  </p>
+
+  <list style="compact">
+    <item><p><link href="https://developer.gnome.org/geocode-glib/unstable/index.html";>Geocode-glib 
reference documentation</link></p></item>
+  </list>
+
+</page>
diff --git a/new-platform-overview/tech.page b/new-platform-overview/tech.page
index c122b1c..b6799d8 100644
--- a/new-platform-overview/tech.page
+++ b/new-platform-overview/tech.page
@@ -63,8 +63,8 @@ list of all the platform libraries in GNOME, sorted by purpose.</p>
 
 <links type="topic"
        style="linklist"
-       groups="champlain geoclue2">
-  <title>Geographcal</title>
+       groups="champlain geoclue2 geocode-glib">
+  <title>Geographical</title>
 </links>
 
 <links type="topic"