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

postgis-commits at postgis.refractions.net postgis-commits at postgis.refractions.net
Tue Oct 7 22:45:46 PDT 2008


Author: kneufeld
Date: 2008-10-07 22:45:46 -0700 (Tue, 07 Oct 2008)
New Revision: 3076

Modified:
   trunk/doc/introduction.xml
   trunk/doc/reference.xml
   trunk/doc/reporting.xml
   trunk/doc/template.xml
   trunk/doc/using_postgis.xml
Log:
fixed several broken or redirected external URLs.

Modified: trunk/doc/introduction.xml
===================================================================
--- trunk/doc/introduction.xml	2008-10-08 04:25:40 UTC (rev 3075)
+++ trunk/doc/introduction.xml	2008-10-08 05:45:46 UTC (rev 3076)
@@ -15,60 +15,72 @@
     <title>Credits</title>
 
     <variablelist>
-	  <varlistentry>
+      <varlistentry>
         <term>Mark Cave-Ayland</term>
+
         <listitem>
-          <para>Coordinates bug fixing and maintenance effort, alignment of PostGIS with PostgreSQL releases, windows build, integration
-          of new GEOS functionality, and new function enhancements.</para>
+          <para>Coordinates bug fixing and maintenance effort, alignment of
+          PostGIS with PostgreSQL releases, windows build, integration of new
+          GEOS functionality, and new function enhancements.</para>
         </listitem>
       </varlistentry>
+
       <varlistentry>
         <term>Paul Ramsey</term>
+
         <listitem>
-          <para>Release Manager, coordinates general direction of the project, 
-		  	often gets his hands dirty doing real coding.</para>
+          <para>Release Manager, coordinates general direction of the project,
+          often gets his hands dirty doing real coding.</para>
         </listitem>
       </varlistentry>
-	  
+
       <varlistentry>
         <term>Mark Leslie</term>
+
         <listitem>
           <para>Ongoing maintenance and development of core functions.</para>
         </listitem>
       </varlistentry>
-	  
+
       <varlistentry>
         <term>Kevin Neufeld</term>
+
         <listitem>
-          <para>Documentation, Hudson automated build, advanced user support on PostGIS newsgroup.</para>
+          <para>Documentation, Hudson automated build, advanced user support
+          on PostGIS newsgroup.</para>
         </listitem>
       </varlistentry>
-	  
-	  <varlistentry>
+
+      <varlistentry>
         <term>Sandro Santilli</term>
+
         <listitem>
-          <para>Bug fixes and maintenance and integration of new GEOS functionality</para>
+          <para>Bug fixes and maintenance and integration of new GEOS
+          functionality</para>
         </listitem>
       </varlistentry>
-	  
+
       <varlistentry>
         <term>Chris Hodgson</term>
+
         <listitem>
           <para>General development</para>
         </listitem>
       </varlistentry>
-	  
-	  <varlistentry>
+
+      <varlistentry>
         <term>Dave Blasby</term>
+
         <listitem>
           <para>The original developer of PostGIS. Dave wrote the server side
           objects, index bindings, and many of the server side analytical
           functions.</para>
         </listitem>
       </varlistentry>
-	  
+
       <varlistentry>
         <term>Jeff Lounsbury</term>
+
         <listitem>
           <para>Original development of the Shape file loader/dumper.</para>
         </listitem>
@@ -78,11 +90,14 @@
         <term>Other contributors</term>
 
         <listitem>
-          <para>In alphabetical order: Alex Bodnaru, Alex Mayrhofer, Barbara Phillipot, Ben Jubb, Bernhard Reiter, Bruce
-          Rindahl, Bruno Wolff III, Carl Anderson, Charlie Savage, Dane Springmeyer, David Skea, 
-		  David Techer, Eduin Carillo, IIDA Tetsushi, Geographic Data BC,
-          Gerald Fenoy, Gino Lucrezi, Klaus Foerster, Kris Jurka, Mark Sondheim, Markus Schaber, Michael Fuhr, Nikita
-          Shulga, Norman Vine, Olivier Courtin, Ralph Mason, Regina Obe, Steffen Macke, Stephen Frost.</para>
+          <para>In alphabetical order: Alex Bodnaru, Alex Mayrhofer, Barbara
+          Phillipot, Ben Jubb, Bernhard Reiter, Bruce Rindahl, Bruno Wolff
+          III, Carl Anderson, Charlie Savage, Dane Springmeyer, David Skea,
+          David Techer, Eduin Carillo, IIDA Tetsushi, Geographic Data BC,
+          Gerald Fenoy, Gino Lucrezi, Klaus Foerster, Kris Jurka, Mark
+          Sondheim, Markus Schaber, Michael Fuhr, Nikita Shulga, Norman Vine,
+          Olivier Courtin, Ralph Mason, Regina Obe, Steffen Macke, Stephen
+          Frost.</para>
         </listitem>
       </varlistentry>
 
@@ -90,12 +105,12 @@
         <term>Important Support Libraries</term>
 
         <listitem>
-          <para>The <ulink url="http://geos.osgeo.org/">GEOS</ulink>
+          <para>The <ulink url="http://trac.osgeo.org/geos/">GEOS</ulink>
           geometry operations library, and the algorithmic work of Martin
-          Davis in
-          making it all work, ongoing maintenance and support of Mateusz Loskot, Paul Ramsey and others.</para>
+          Davis in making it all work, ongoing maintenance and support of
+          Mateusz Loskot, Paul Ramsey and others.</para>
 
-          <para>The <ulink url="http://proj.osgeo.org">Proj4</ulink>
+          <para>The <ulink url="http://trac.osgeo.org/proj/">Proj4</ulink>
           cartographic projection library, and the work of Gerald Evenden and
           Frank Warmerdam in creating and maintaining it.</para>
         </listitem>
@@ -115,14 +130,14 @@
 
       <listitem>
         <para>More information about the GEOS geometry operations library is
-        available at<ulink url="http://geos.osgeo.org/">
-       http://geos.osgeo.org/</ulink>.</para>
+        available at<ulink url="http://trac.osgeo.org/geos/">
+        http://trac.osgeo.org/geos/</ulink>.</para>
       </listitem>
 
       <listitem>
         <para>More information about the Proj4 reprojection library is
         available at <ulink
-        url="http://proj.osgeo.org">http://proj.osgeo.org</ulink>.</para>
+        url="http://trac.osgeo.org/proj/">http://trac.osgeo.org/proj/</ulink>.</para>
       </listitem>
 
       <listitem>
@@ -134,7 +149,7 @@
       <listitem>
         <para>More information about GiST indexing is available at the
         PostgreSQL GiST development site, <ulink
-        url="http://www.sai.msu.su/~megera/postgres/gist">http://www.sai.msu.su/~megera/postgres/gist</ulink>.</para>
+        url="http://www.sai.msu.su/~megera/postgres/gist/">http://www.sai.msu.su/~megera/postgres/gist/</ulink>.</para>
       </listitem>
 
       <listitem>
@@ -144,10 +159,11 @@
       </listitem>
 
       <listitem>
-        <para>The "<ulink url="http://www.opengis.org/docs/99-049.pdf">Simple
-        Features for Specification for SQL</ulink>" is available at the
-        OpenGIS Consortium web site: <ulink
-        url="http://www.opengis.org">http://www.opengis.org</ulink>.</para>
+        <para>The "<ulink
+        url="http://www.opengeospatial.org/standards/sfs">Simple Features for
+        Specification for SQL</ulink>" is available at the OpenGIS Consortium
+        web site: <ulink
+        url="http://www.opengeospatial.org/">http://www.opengeospatial.org/</ulink>.</para>
       </listitem>
     </itemizedlist>
   </sect1>

Modified: trunk/doc/reference.xml
===================================================================
--- trunk/doc/reference.xml	2008-10-08 04:25:40 UTC (rev 3075)
+++ trunk/doc/reference.xml	2008-10-08 05:45:46 UTC (rev 3076)
@@ -1519,7 +1519,7 @@
 
       <para>This module and associated pl/pgsql functions have been
       implemented to provide long locking support required by <ulink
-      url="https://portal.opengeospatial.org/files/?artifact_id=7176">Web
+      url="http://portal.opengeospatial.org/files/index.php?artifact_id=7176">Web
       Feature Service</ulink> specification.</para>
 
       <note>

Modified: trunk/doc/reporting.xml
===================================================================
--- trunk/doc/reporting.xml	2008-10-08 04:25:40 UTC (rev 3075)
+++ trunk/doc/reporting.xml	2008-10-08 05:45:46 UTC (rev 3076)
@@ -14,7 +14,7 @@
     version()</code> [for postgresql].</para>
 
     <para>If you aren't using the latest release, it's worth taking a look at
-    its <ulink url="http://postgis.refractions.net/CHANGES.txt">release
+    its <ulink url="http://svn.refractions.net/postgis/trunk/NEWS">release
     changelog</ulink> first, to find out if your bug has already been
     fixed.</para>
 

Modified: trunk/doc/template.xml
===================================================================
--- trunk/doc/template.xml	2008-10-08 04:25:40 UTC (rev 3075)
+++ trunk/doc/template.xml	2008-10-08 05:45:46 UTC (rev 3076)
@@ -1,25 +1,18 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<refentry id="ST_MyMethod">
+<refentry id="ST_IsRing">
   <refnamediv>
-    <refname>ST_MyMethod</refname>
+    <refname>ST_IsRing</refname>
 
-    <refpurpose>Returns something useful</refpurpose>
+    <refpurpose>Returns <varname>TRUE</varname> if this
+    <varname>LINESTRING</varname> is both closed and simple.</refpurpose>
   </refnamediv>
 
   <refsynopsisdiv>
     <funcsynopsis>
       <funcprototype>
-        <funcdef>boolean <function>ST_MyMethod</function></funcdef>
-        <paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>
-        <paramdef><type>geometry </type> <parameter>g2</parameter></paramdef>
-      </funcprototype>
+        <funcdef>boolean <function>ST_IsRing</function></funcdef>
 
-      <!-- an optional second method prototype -->
-      <funcprototype>
-        <funcdef>boolean <function>ST_MyMethod</function></funcdef>
-        <paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>
-        <paramdef><type>geometry </type> <parameter>g2</parameter></paramdef>
-        <paramdef><type>varchar </type> <parameter>myparam</parameter></paramdef>
+        <paramdef><type>geometry </type> <parameter>g</parameter></paramdef>
       </funcprototype>
     </funcsynopsis>
   </refsynopsisdiv>
@@ -27,31 +20,34 @@
   <refsection>
     <title>Description</title>
 
-    <para>Some useful description here.</para>
+    <para>Returns <varname>TRUE</varname> if this
+    <varname>LINESTRING</varname> is both <xref linkend="ST_IsClosed" />
+    (<function>ST_StartPoint(<parameter>g</parameter>)</function>
+    <function>~=</function>
+    <function>ST_Endpoint(<parameter>g</parameter>)</function>) and <xref
+    linkend="ST_IsSimple" /> (does not self intersect).</para>
 
-    <!-- optionally mention that this function uses indexes if appropriate -->
-    <note>
-      <para>This function call will automatically include a bounding box
-      comparison that will make use of any indexes that are available on the
-      geometries.</para>
-    </note>
-
-    <!-- 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.</ulink></para>
+    Implementation Specification for SQL.</ulink> OGC SFSQL 1.1 -
+    2.1.5.1</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: 5.1.23</para>
+    SQL-MM 3: 7.1.6</para>
+
+    <note>
+      <para>SQL-MM defines the result of
+      <function>ST_IsRing(<varname>NULL</varname>)</function> to be 0, while
+      PostGIS returns <varname>NULL</varname>.</para>
+    </note>
 	
 	<!-- Optionally mention 3d support -->
     <para><inlinemediaobject>
@@ -65,13 +61,14 @@
   <refsection>
     <title>Examples</title>
 
-    <programlisting></programlisting>
+    <programlisting>
+</programlisting>
   </refsection>
 
-  <!-- Optionally add a "See Also" section -->
   <refsection>
     <title>See Also</title>
 
-    <para><xref linkend="ST_MyMethod2" />, ...</para>
+    <para><xref linkend="ST_IsSimple" />, <xref linkend="ST_StartPoint" />,
+    <xref linkend="ST_EndPoint" /></para>
   </refsection>
 </refentry>
\ No newline at end of file

Modified: trunk/doc/using_postgis.xml
===================================================================
--- trunk/doc/using_postgis.xml	2008-10-08 04:25:40 UTC (rev 3075)
+++ trunk/doc/using_postgis.xml	2008-10-08 05:45:46 UTC (rev 3076)
@@ -357,13 +357,13 @@
 
             <para>For a listing of EPSG projection codes and their
             corresponding WKT representations, see <ulink
-            url="http://www.opengis.org/techno/interop/EPSG2WKT.TXT">http://www.opengis.org/techno/interop/EPSG2WKT.TXT</ulink>.
+            url="http://www.opengeospatial.org/">http://www.opengeospatial.org/</ulink>.
             For a discussion of WKT in general, see the OpenGIS "Coordinate
             Transformation Services Implementation Specification" at <ulink
-            url="http://www.opengis.org/techno/specs.htm">http://www.opengis.org/techno/specs.htm</ulink>.
+            url="http://www.opengeospatial.org/standards">http://www.opengeospatial.org/standards</ulink>.
             For information on the European Petroleum Survey Group (EPSG) and
             their database of spatial reference systems, see <ulink
-            url="http://epsg.org">http://epsg.org</ulink>.</para>
+            url="http://www.epsg.org/">http://www.epsg.org</ulink>.</para>
           </listitem>
         </varlistentry>
 
@@ -379,7 +379,7 @@
             <programlisting>+proj=utm +zone=10 +ellps=clrk66 +datum=NAD27 +units=m</programlisting>
 
             <para>For more information about, see the Proj4 web site at <ulink
-            url="http://proj.osgeo.org">http://proj.osgeo.org</ulink>.
+            url="http://trac.osgeo.org/proj/">http://trac.osgeo.org/proj/</ulink>.
             The <filename>spatial_ref_sys.sql</filename> file contains both
             <varname>SRTEXT</varname> and <varname>PROJ4TEXT</varname>
             definitions for all EPSG projections.</para>
@@ -1356,7 +1356,7 @@
 
       <listitem>
         <para>The OpenGIS Web Map Specification is at <ulink
-        url="http://www.opengis.org/techno/specs/01-047r2.pdf">http://www.opengis.org/techno/specs/01-047r2.pdf</ulink>.</para>
+        url="http://www.opengeospatial.org/standards">http://www.opengeospatial.org/standards</ulink>.</para>
       </listitem>
     </itemizedlist>
 



More information about the postgis-commits mailing list