From: Regina Obe <lr@pcorp.us>
Date: Fri, 2 Oct 2009 19:08:51 +0000 (+0000)
Subject: add geography proto for ST_DWithin, also fill in some availability marks forgotten.
X-Git-Tag: 1.5.0b1~429
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=e8e6dd4f73975c61e1d17eef6e9ca31ef87869cf;p=postgis

add geography proto for ST_DWithin, also fill in some availability marks forgotten.

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

diff --git a/doc/reference.xml b/doc/reference.xml
index 3be4f7b65..fc2591a16 100644
--- a/doc/reference.xml
+++ b/doc/reference.xml
@@ -7069,7 +7069,7 @@ CREATE INDEX idx_the_geom_26986_parcels
 			  <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>Availability: 1.5.0 geography support was introduced.</para>
 
 			<para><inlinemediaobject>
 				<imageobject>
@@ -7400,6 +7400,7 @@ CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)
 			<para>Version 6: ST_AsGeoJSON(version, geom, precision,options)</para>
 
 			<para>Availability: 1.3.4</para>
+			<para>Availability: 1.5.0 geography support was introduced.</para>
 			<!-- Optionally mention 3d support -->
 			<para><inlinemediaobject>
 			<imageobject>
@@ -7527,6 +7528,7 @@ st_asgeojson
 
 		<note>
 		  <para>Availability: 1.3.2</para>
+		  <para>Availability: 1.5.0 geography support was introduced.</para>
 		</note>
 
 		<!-- Optionally mention 3d support -->
@@ -10092,6 +10094,8 @@ SELECT ST_Disjoint('POINT(0 0)'::geometry, 'LINESTRING ( 0 0, 0 2 )'::geometry);
 		  <inlinegraphic fileref="images/check.png" />
 		  This method implements the SQL/MM specification: SQL-MM 3: 5.1.23
 		</para>
+		
+		<para>Availability: 1.5.0 geography support was introduced in 1.5.</para>
 	  </refsection>
 
 	  <refsection>
@@ -10107,7 +10111,7 @@ st_distance
 -----------------
 0.00150567726382282
 
--- Geometry example - units in meters (SRID: 26986 Massachusetts state plane meters)
+-- Geometry example - units in meters (SRID: 26986 Massachusetts state plane meters) (most accurate for Massachusetts)
 SELECT ST_Distance(
 			ST_Transform(ST_GeomFromText('POINT(-72.1235 42.3521)',4326),26986), 
 			ST_Transform(ST_GeomFromText('LINESTRING(-72.1260 42.45, -72.123 42.1546)', 4326),26986)
@@ -10116,7 +10120,7 @@ st_distance
 -----------------
 123.797937878454
 
--- Geometry example - units in meters (SRID: 2163 US National Atlas Equal area)
+-- Geometry example - units in meters (SRID: 2163 US National Atlas Equal area) (least accurate)
 SELECT ST_Distance(
 			ST_Transform(ST_GeomFromText('POINT(-72.1235 42.3521)',4326),2163), 
 			ST_Transform(ST_GeomFromText('LINESTRING(-72.1260 42.45, -72.123 42.1546)', 4326),2163)
@@ -10126,7 +10130,7 @@ st_distance
 ------------------
 126.664256056812
 
--- Geography example -- same but note units in meters
+-- Geography example -- same but note units in meters 
 SELECT ST_Distance(
 	ST_GeographyFromText('SRID=4326;POINT(-72.1235 42.3521)'), 
 	ST_GeographyFromText('SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)')
@@ -10348,7 +10352,7 @@ FROM
 		<refname>ST_DWithin</refname>
 
 		<refpurpose>Returns true if the geometries are within the specified
-		distance of one another</refpurpose>
+		distance of one another. For geometry units are in those of spatial reference and For geography units are in meters.</refpurpose>
 	  </refnamediv>
 
 	  <refsynopsisdiv>
@@ -10362,6 +10366,19 @@ FROM
 			<paramdef><type>geometry </type>
 			<parameter>g2</parameter></paramdef>
 
+			<paramdef><type>double precision </type>
+			<parameter>distance</parameter></paramdef>
+		  </funcprototype>
+		  
+		   <funcprototype>
+			<funcdef>boolean <function>ST_DWithin</function></funcdef>
+
+			<paramdef><type>geography </type>
+			<parameter>gg1</parameter></paramdef>
+
+			<paramdef><type>geography </type>
+			<parameter>gg2</parameter></paramdef>
+
 			<paramdef><type>double precision </type>
 			<parameter>distance</parameter></paramdef>
 		  </funcprototype>
@@ -10396,6 +10413,8 @@ FROM
 		  <ulink url="http://www.opengeospatial.org/standards/sfs">OpenGIS Simple
 		  Features Implementation Specification for SQL.</ulink>
 		</para>
+		
+		<para>Availability: 1.5.0 support for geography was introduced</para>
 	  </refsection>
 
 	  <refsection>