From: Regina Obe <lr@pcorp.us>
Date: Tue, 4 May 2010 17:17:22 +0000 (+0000)
Subject: Provide at least one example of ST_GeogFromText
X-Git-Tag: 2.0.0alpha1~3000
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ad367ca4c415fc8afc5bd61ca24d1e29d826a745;p=postgis

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 c66875d6c..ff503b57f 100644
--- 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>