From 065a716fde2c5e4ec4d42f3eae591ac0ee91965c Mon Sep 17 00:00:00 2001
From: Regina Obe <lr@pcorp.us>
Date: Tue, 22 Sep 2009 21:14:26 +0000
Subject: [PATCH] start putting in geography functions

git-svn-id: http://svn.osgeo.org/postgis/trunk@4528 b70326c6-7e19-0410-871a-916f4a2858ee
---
 doc/reference.xml | 45 ++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 40 insertions(+), 5 deletions(-)

diff --git a/doc/reference.xml b/doc/reference.xml
index f6813bc8e..8db58c73d 100644
--- a/doc/reference.xml
+++ b/doc/reference.xml
@@ -1125,6 +1125,30 @@ probed:6 inserted:0 conflicts:6 stale:0
 				<para><xref linkend="ST_BuildArea" />, <xref linkend="ST_BdPolyFromText" /></para>
 			</refsection>
 	</refentry>
+	
+	<refentry id="ST_GeographyFromText">
+		  <refnamediv>
+			<refname>ST_GeographyFromText</refname>
+			<refpurpose>Return a specified geography value from Well-Known Text representation or extended (WKT). </refpurpose>
+		  </refnamediv>
+		  <refsynopsisdiv>
+			<funcsynopsis>
+			  <funcprototype>
+				<funcdef>geography <function>ST_GeographyFromText</function></funcdef>
+				<paramdef><type>text </type> <parameter>EWKT</parameter></paramdef>
+			  </funcprototype>
+			</funcsynopsis>
+		  </refsynopsisdiv>
+		  <refsection>
+			<title>Description</title>
+			<para>Returns a geography object from the  well-known text representation.  SRID 4326 is assumed.</para>
+			<!-- TODO: put in example -->
+		  </refsection>
+		  <refsection>
+			<title>See Also</title>
+			<para><xref linkend="ST_AsText" /></para>
+		  </refsection>
+	</refentry>
 
 
 	<refentry id="ST_GeomCollFromText">
@@ -1335,7 +1359,6 @@ SELECT ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 15
 		<para><xref linkend="ST_AsEWKT" />, <xref linkend="ST_GeomFromText" />, <xref linkend="ST_GeomFromEWKT" /></para>
 	  </refsection>
 	</refentry>
-
 	<refentry id="ST_GeometryFromText">
 		  <refnamediv>
 			<refname>ST_GeometryFromText</refname>
@@ -7009,7 +7032,7 @@ CREATE INDEX idx_the_geom_26986_parcels
 		  <refentry id="ST_AsBinary">
 		  <refnamediv>
 			<refname>ST_AsBinary</refname>
-			<refpurpose>Return the Well-Known Binary (WKB) representation of the geometry without SRID meta data.</refpurpose>
+			<refpurpose>Return the Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.</refpurpose>
 		  </refnamediv>
 
 		  <refsynopsisdiv>
@@ -7018,6 +7041,10 @@ CREATE INDEX idx_the_geom_26986_parcels
 				<funcdef>bytea <function>ST_AsBinary</function></funcdef>
 				<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>
 			  </funcprototype>
+			  <funcprototype>
+				<funcdef>text <function>ST_AsText</function></funcdef>
+				<paramdef><type>geography </type> <parameter>g1</parameter></paramdef>
+			  </funcprototype>
 			  <funcprototype>
 				<funcdef>bytea <function>ST_AsBinary</function></funcdef>
 				<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>
@@ -7039,8 +7066,10 @@ CREATE INDEX idx_the_geom_26986_parcels
 			  <para>The WKB spec does not include the SRID.  To get the OGC WKB with SRID format use ST_AsEWKB</para>
 			</note>
 			<note>
-			  <para>ST_AsBinary is the reverse of <xref linkend="ST_GeomFromWKB" />.  Use <xref linkend="ST_GeomFromWKB" /> to convert to a postgis geometry from ST_AsBinary representation.</para>
+			  <para>ST_AsBinary is the reverse of <xref linkend="ST_GeomFromWKB" /> for geometry.  Use <xref linkend="ST_GeomFromWKB" /> to convert to a postgis geometry from ST_AsBinary representation.</para>
 			</note>
+			
+			<para>Availability: 1.5 geography support was introduced.</para>
 
 			<para><inlinemediaobject>
 				<imageobject>
@@ -7741,7 +7770,7 @@ SELECT ST_GeoHash(ST_SetSRID(ST_MakePoint(-126,48),4326),5);
 	<refentry id="ST_AsText">
 		  <refnamediv>
 			<refname>ST_AsText</refname>
-			<refpurpose>Return the Well-Known Text (WKT) representation of the geometry without SRID metadata.</refpurpose>
+			<refpurpose>Return the Well-Known Text (WKT) representation of the geometry/geography without SRID metadata.</refpurpose>
 		  </refnamediv>
 
 		  <refsynopsisdiv>
@@ -7750,13 +7779,17 @@ SELECT ST_GeoHash(ST_SetSRID(ST_MakePoint(-126,48),4326),5);
 				<funcdef>text <function>ST_AsText</function></funcdef>
 				<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>
 			  </funcprototype>
+			  <funcprototype>
+				<funcdef>text <function>ST_AsText</function></funcdef>
+				<paramdef><type>geography </type> <parameter>g1</parameter></paramdef>
+			  </funcprototype>
 			</funcsynopsis>
 		  </refsynopsisdiv>
 
 		  <refsection>
 			<title>Description</title>
 
-			<para>Returns the Well-Known Text representation of the geometry.</para>
+			<para>Returns the Well-Known Text representation of the geometry/geography.</para>
 
 			<note>
 			  <para>The WKT spec does not include the SRID.  To get the SRID as part of the data, use the non-standard
@@ -7768,6 +7801,8 @@ SELECT ST_GeoHash(ST_SetSRID(ST_MakePoint(-126,48),4326),5);
 			<note>
 			  <para>ST_AsText is the reverse of <xref linkend="ST_GeomFromText" />.  Use <xref linkend="ST_GeomFromText" /> to convert to a postgis geometry from ST_AsText representation.</para>
 			</note>
+			
+			<para>Availability: 1.5 - support for geography was introduced.</para>
 
 			<!-- Optionally mention OpenGIS compliancy if appropriate -->
 			<para><inlinemediaobject>
-- 
2.49.0