From: Regina Obe <lr@pcorp.us>
Date: Mon, 4 Aug 2008 11:50:16 +0000 (+0000)
Subject: Moved over ST_SRID, fixed a typo, added some references
X-Git-Tag: 1.4.0b1~787
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=0ad5ab72fa3cbe2f6815d50ea82352fe8c160741;p=postgis

Moved over ST_SRID, fixed a typo, added some references

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

diff --git a/doc/reference.xml b/doc/reference.xml
index 1d0710f89..fa25f65eb 100644
--- a/doc/reference.xml
+++ b/doc/reference.xml
@@ -277,17 +277,6 @@
       <title>Geometry Accessors</title>
 
       <variablelist>
-        <varlistentry id="ST_SRID">
-          <term>ST_SRID(geometry)</term>
-
-          <listitem>
-            <para>Returns the integer SRID number of the spatial reference
-            system of the geometry.</para>
-
-            <para>OGC SPEC s2.1.1.1</para>
-          </listitem>
-        </varlistentry>
-
         <varlistentry>
           <term>ST_Dimension(geometry)</term>
 
@@ -2335,17 +2324,6 @@ WHERE n*100.00/length &lt; 1;
         </listitem>
       </varlistentry>
 
-      <varlistentry>
-        <term>ST_SRID</term>
-
-        <listitem>
-          <para>Return the spatial reference system identifier of the
-          ST_Geometry value.</para>
-
-          <para>SQL-MM 3: 5.1.5</para>
-        </listitem>
-      </varlistentry>
-
       <varlistentry>
         <term>ST_StartPoint</term>
 
diff --git a/doc/reference_new.xml b/doc/reference_new.xml
index d701a4b9b..981cef2d1 100644
--- a/doc/reference_new.xml
+++ b/doc/reference_new.xml
@@ -1242,7 +1242,7 @@ SELECT ST_GeomFromText('MULTIPOLYGON(((-71.1031880899493 42.3152774590236,
 		  </refsection>
 		  <refsection>
 			<title>See Also</title>
-			<para><xref linkend="ST_GeomFromEWKT" />, <xref linkend="ST_GeomFromWKB" /></para>
+			<para><xref linkend="ST_GeomFromEWKT" />, <xref linkend="ST_GeomFromWKB" />, <xref linkend="ST_SRID" /></para>
 		  </refsection>
 	</refentry>
 		
@@ -1302,16 +1302,11 @@ SELECT userpoints.id, ST_MakeLine(startpoint, endpoint) As drawn_line
 	FROM userpoints ;
 			</programlisting>
 		</refsection>
-	</refentry>
-	        <varlistentry>
-          <term>ST_MakePoint(&lt;x&gt;, &lt;y&gt;, [&lt;z&gt;],
-          [&lt;m&gt;])</term>
-
-          <listitem>
-            <para>Creates a 2d,3dz or 4d point geometry.</para>
-          </listitem>
-        </varlistentry>
-		
+		<refsection>
+			<title>See Also</title>
+			<para><xref linkend="ST_GeomFromText" />, <xref linkend="ST_MakePoint" /></para>
+		</refsection>
+	</refentry>	
 <refentry id="ST_MakePoint">
 		<refnamediv>
 		<refname>ST_MakePoint</refname>
@@ -1914,6 +1909,59 @@ POINT(1 2)
 		<para><xref linkend="ST_NPoints" /></para>
 	  </refsection>
 	</refentry>
+	<refentry id="ST_SRID">
+	  <refnamediv>
+		<refname>ST_SRID</refname>
+		<refpurpose>Returns the spatial reference identifier for the ST_Geometry as defined in spatial_ref_sys table.</refpurpose>
+	  </refnamediv>
+	
+	  <refsynopsisdiv>
+		<funcsynopsis>
+		  <funcprototype>
+			<funcdef>integer <function>ST_SRID</function></funcdef>
+			<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>
+		  </funcprototype>
+		</funcsynopsis>
+	  </refsynopsisdiv>
+	
+	  <refsection>
+		<title>Description</title>
+	
+		<para>Returns the spatial reference identifier for the ST_Geometry as defined in spatial_ref_sys table. </para>
+		<para><note>spatial_ref_sys
+		table is a table that catalogs all spatial reference systems known to PostGIS and is used for transformations from one spatial
+			reference system to another.  So verifying you have the right spatial reference system identifier is important if you plan to ever transform your geometries.</note></para>
+		<para><inlinemediaobject>
+			<imageobject>
+			  <imagedata fileref="images/check.png" />
+			</imageobject>
+		  </inlinemediaobject> This method implements the <ulink
+		url="http://www.opengeospatial.org/standards/sfs">OpenGIS Simple Features
+		Implementation Specification for SQL.</ulink>
+		OGC SPEC s2.1.1.1</para>
+
+		<para><inlinemediaobject>
+			<imageobject>
+			  <imagedata fileref="images/check.png" />
+			</imageobject>
+		  </inlinemediaobject> This method implements the SQL/MM specification:
+		SQL-MM 3: 5.1.5</para>
+	  </refsection>
+	
+	  <refsection>
+		<title>Examples</title>
+	
+		<programlisting>SELECT ST_SRID(ST_GeomFromText('POINT(-71.1043 42.315)',4326));
+		--result
+		4326
+		</programlisting>
+	  </refsection>
+	  <refsection>
+		<title>See Also</title>
+	
+		<para><xref linkend="ST_GeomFromText" />, <xref linkend="ST_SetSRID" />, <xref linkend="ST_Transform" /></para>
+	  </refsection>
+	</refentry>
   </sect1>
   
   <sect1>
@@ -2132,7 +2180,7 @@ LINESTRING(1 2,1 10) | LINESTRING(1 10,1 2)
       <refsection>
         <title>See Also</title>
 
-        <para><xref linkend="ST_Transform"/>, <xref linkend="UpdateGeometrySRID"/></para>
+        <para><xref linkend="ST_SRID"/>, <xref linkend="ST_Transform"/>, <xref linkend="UpdateGeometrySRID"/></para>
       </refsection>
       
     </refentry>