Provide at least one example of ST_GeogFromText

git-svn-id: http://svn.osgeo.org/postgis/trunk@5611 b70326c6-7e19-0410-871a-916f4a2858ee

diff --git a/doc/reference_constructor.xml b/doc/reference_constructor.xml
index c66875d6c44731ab561cbd7ca8268bcc219526f6..ff503b57fcbeabd3c3dfb3cc7782df53a8c7cdf3 100644 (file)
--- a/doc/reference_constructor.xml
+++ b/doc/reference_constructor.xml
@@ -118,9 +118,17 @@
                  <refsection>
                        <title>Description</title>
                        <para>Returns a geography object from the  well-known text or extended well-known representation.  SRID 4326 is assumed. This
-                               is an alias for ST_GeographyFromText</para>
-                       <!-- TODO: put in example -->
+                               is an alias for ST_GeographyFromText.  Points are always expressed in long lat form.</para>
                  </refsection>
+                 
+                <refsection>
+                               <title>Examples</title>
+                               <programlisting>
+--- converting lon lat coords to geography
+ALTER TABLE sometable ADD COLUMN geog geography(POINT,4326);
+UPDATE sometable SET geog = ST_GeogFromText('SRID=4326;POINT(' || lon || ' ' || lat || ')');           
+                               </programlisting>
+                </refsection>
                  <refsection>
                        <title>See Also</title>
                        <para><xref linkend="ST_AsText" />,<xref linkend="ST_GeographyFromText" /></para>
@@ -147,7 +155,7 @@
                  </refsection>
                  <refsection>
                        <title>See Also</title>
-                       <para><xref linkend="ST_AsText" /></para>
+                       <para><xref linkend="ST_GeogFromText" />, <xref linkend="ST_AsText" /></para>
                  </refsection>
        </refentry>