[postgis-commits] svn - r3530 - trunk/doc

[postgis-commits at postgis.refractions.net]

Author: robe
Date: 2009-01-15 10:14:53 -0800 (Thu, 15 Jan 2009)
New Revision: 3530

Modified:
   trunk/doc/reference.xml
   trunk/doc/reference_new.xml
Log:
Move over MPointFromText

Modified: trunk/doc/reference.xml
===================================================================
--- trunk/doc/reference.xml	2009-01-15 15:10:21 UTC (rev 3529)
+++ trunk/doc/reference.xml	2009-01-15 18:14:53 UTC (rev 3530)
@@ -25,20 +25,6 @@
       <variablelist>
 
         <varlistentry>
-          <term>ST_MPointFromText(text,[&lt;srid&gt;])</term>
-
-          <listitem>
-            <para>Makes a Geometry from WKT with the given SRID. If SRID is
-            not give, it defaults to -1.</para>
-
-            <para>OGC SPEC 3.2.6.2 - option SRID is from the conformance
-            suite</para>
-
-            <para>Throws an error if the WKT is not a MULTIPOINT</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
           <term>ST_MLineFromText(text,[&lt;srid&gt;])</term>
 
           <listitem>
@@ -380,16 +366,6 @@
       </varlistentry>
 
       <varlistentry>
-        <term>ST_MPointFromText</term>
-
-        <listitem>
-          <para>Return a specified ST_MultiPoint value.</para>
-
-          <para>SQL-MM 3: 9.2.4</para>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry>
         <term>ST_MPointFromWKB</term>
 
         <listitem>

Modified: trunk/doc/reference_new.xml
===================================================================
--- trunk/doc/reference_new.xml	2009-01-15 15:10:21 UTC (rev 3529)
+++ trunk/doc/reference_new.xml	2009-01-15 18:14:53 UTC (rev 3530)
@@ -2204,7 +2204,82 @@
 			<para><xref linkend="ST_AsEWKT" />, <xref linkend="ST_MakePoint" />, <xref linkend="ST_SetSRID" /></para>
 		</refsection>
 	</refentry>	
+		
+	<refentry id="ST_MPointFromText">
+	  <refnamediv>
+	    <refname>ST_MPointFromText</refname>
 	
+	    <refpurpose>Makes a Geometry from WKT with the given SRID. If SRID is
+            not give, it defaults to -1.</refpurpose>
+	  </refnamediv>
+	
+	  <refsynopsisdiv>
+	    <funcsynopsis>
+	      <funcprototype>
+	        <funcdef>geometry <function>ST_MPointFromText</function></funcdef>
+	        <paramdef><type>text </type> <parameter>WKT</parameter></paramdef>
+	        <paramdef><type>integer </type> <parameter>srid</parameter></paramdef>
+	      </funcprototype>
+		  
+		  <funcprototype>
+	        <funcdef>geometry <function>ST_MPointFromText</function></funcdef>
+	        <paramdef><type>text </type> <parameter>WKT</parameter></paramdef>
+	      </funcprototype>
+
+	    </funcsynopsis>
+	  </refsynopsisdiv>
+	
+	  <refsection>
+	    <title>Description</title>
+	
+	     <para>Makes a Geometry from WKT with the given SRID. If SRID is
+            not give, it defaults to -1.</para>
+
+         <para>OGC SPEC 3.2.6.2 - option SRID is from the conformance
+            suite</para>
+
+         <para>Returns null if the WKT is not a MULTIPOINT</para>
+	
+	    <!-- Optionally mention OpenGIS compliancy if appropriate -->
+	    <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. OGC SPEC 3.2.6.2</ulink></para>
+	
+	    <!-- Optionally mention SQL/MM compliancy if appropriate -->
+	    <para><inlinemediaobject>
+	        <imageobject>
+	          <imagedata fileref="images/check.png" />
+	        </imageobject>
+	      </inlinemediaobject> This method implements the SQL/MM specification: SQL-MM 3: 9.2.4</para>
+		
+		<!-- Optionally mention 3d support -->
+	    <para><inlinemediaobject>
+	        <imageobject>
+	          <imagedata fileref="images/check.png" />
+	        </imageobject>
+	      </inlinemediaobject> This function supports 3d and will not drop the z-index.</para>
+	  </refsection>
+	  
+	
+	  <refsection>
+	    <title>Examples</title>
+	
+	    <programlisting>SELECT ST_MPointFromText('MULTIPOINT(1 2, 3 4)');
+SELECT ST_MPointFromText('MULTIPOINT(-70.9590 42.1180, -70.9611 42.1223)', 4326);</programlisting>
+	  </refsection>
+	
+	  <!-- Optionally add a "See Also" section -->
+	  <refsection>
+	    <title>See Also</title>
+	
+	    <para><xref linkend="ST_MyMethod2" />, ...</para>
+	  </refsection>
+	</refentry>
+	
 	<refentry id="ST_Point">
 	  <refnamediv>
 	    <refname>ST_Point</refname>