Add a new special index section to collect functions that take as input or output...

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

diff --git a/doc/using_postgis_dataman.xml b/doc/using_postgis_dataman.xml
index 54f943b082cbcb9c84e8c4643edda24722b6a36f..1deff45d6a52c4fe5f8e21916807a268af4d26d2 100644 (file)
--- a/doc/using_postgis_dataman.xml
+++ b/doc/using_postgis_dataman.xml
@@ -169,7 +169,7 @@ geometry
 (1 row)</programlisting>
        </sect2>
 
-       <sect2>
+       <sect2 id="PostGIS_Geography">
          <title>PostGIS Geography Type</title>
 
          <para>The geography type provides native support for spatial features represented on "geographic" coordinates (sometimes called "geodetic" coordinates, or "lat/lon", or "lon/lat"). Geographic coordinates are spherical coordinates expressed in angular units (degrees). </para>
@@ -187,9 +187,9 @@ geometry
 
          <para>The new geography type uses the PostgreSQL 8.3+ typmod definition format so that a table with a geography field
                        can be added in a single step.  All the standard OGC formats except for curves are supported.</para>
-                       
+
        <para>Geography Basics</para>
- 
+
 
 
         <para>The geography type only supports the simplest of simple features. Standard geometry type data will autocast to geography if it is of SRID 4326.  You can also use the EWKT and EWKB
@@ -222,17 +222,17 @@ geometry
                </listitem>
                <!-- TODO: Add other examples -->
                </itemizedlist>
-               <para>The new geography fields don't get registered in the geometry_columns.  They get registered in a new view called
-                               geography_columns which is a view against the system catalogs so is always automatically kept up to date without need 
+               <para>The new geography fields don't get registered in the geometry_columns.  They get registered in a new view called
+                               geography_columns which is a view against the system catalogs so is always automatically kept up to date without need
                                        for an AddGeom... like function.</para>
-                               
+
                <para>Now, check the "geography_columns" view and see that your table is listed:</para>
 
                <para><programlisting>SELECT * FROM geography_columns;</programlisting></para>
 
                <para>Using Input/Output Functions</para>
 
-               <para>There are only four intput/output functions at this time supporting the OGC well-known text (WKT) and well-known binary (WKB) formats. 
+               <para>There are only four intput/output functions at this time supporting the OGC well-known text (WKT) and well-known binary (WKB) formats.
                Adding further output formats (GML, GeoJSON) should be straight-forward, borrowing code from the geometry implementations.</para>
 
                <itemizedlist>

diff --git a/doc/xsl/postgis_aggs_mm.xml.xsl b/doc/xsl/postgis_aggs_mm.xml.xsl
index 60bd456410aca03d6e22b93b3cda5420b236555e..db9ff4cb0329087aa3b02b123a9f1b2ddf0c9147 100644 (file)
--- a/doc/xsl/postgis_aggs_mm.xml.xsl
+++ b/doc/xsl/postgis_aggs_mm.xml.xsl
@@ -70,6 +70,35 @@
                                </itemizedlist>\r
                </sect1>\r
 \r
+               <sect1 id="PostGIS_GeographyFunctions">\r
+                       <title>PostGIS Geography Support Functions</title>\r
+                       <para>The functions and operators given below are PostGIS functions/operators that take as input or return as output a <link linkend="PostGIS_Geography">geography</link> data type object.</para>\r
+                               <itemizedlist>\r
+                       <!-- Pull out the purpose section for each ref entry and strip whitespace and put in a variable to be tagged unto each function comment  -->\r
+                               <xsl:for-each select='sect1/refentry'>\r
+                                       <xsl:sort select="@id"/>\r
+                                       <xsl:variable name='comment'>\r
+                                               <xsl:value-of select="normalize-space(translate(translate(refnamediv/refpurpose,'&#x0d;&#x0a;', ' '), '&#09;', ' '))"/>\r
+                                       </xsl:variable>\r
+                                       <xsl:variable name="refid">\r
+                                               <xsl:value-of select="@id" />\r
+                                       </xsl:variable>\r
+                                       <xsl:variable name="refname">\r
+                                               <xsl:value-of select="refnamediv/refname" />\r
+                                       </xsl:variable>\r
+\r
+                       <!-- For each proto function accepts or returns a geography -->\r
+                                       <xsl:for-each select="refsynopsisdiv/funcsynopsis/funcprototype">\r
+                                               <xsl:choose>\r
+                                                       <xsl:when test="contains(paramdef/type,'geography') or contains(funcdef,'geography')">\r
+                                                               <listitem><link linkend="{$refid}"><xsl:value-of select="$refname" /></link> - <xsl:value-of select="$comment" /></listitem>\r
+                                                       </xsl:when>\r
+                                               </xsl:choose>\r
+                                       </xsl:for-each>\r
+                               </xsl:for-each>\r
+                               </itemizedlist>\r
+               </sect1>\r
+\r
                <sect1 id="PostGIS_3D_Functions">\r
                        <title>PostGIS Functions that support 3D</title>\r
                        <para>The functions given below are PostGIS functions that do not throw away the Z-Index.</para>\r
@@ -126,6 +155,8 @@
                                </itemizedlist>\r
                </sect1>\r
 \r
+\r
+\r
                <sect1 id="NewFunctions">\r
                        <title>New PostGIS Functions</title>\r
                        <sect2 id="NewFunctions_1_5">\r
@@ -141,7 +172,7 @@
                                                <xsl:variable name="refid">\r
                                                        <xsl:value-of select="@id" />\r
                                                </xsl:variable>\r
-       \r
+\r
                                <!-- For each section if there is note about availability in this version -->\r
                                                        <xsl:for-each select="refsection">\r
                                                                <xsl:for-each select="para">\r
@@ -168,7 +199,7 @@
                                                <xsl:variable name="refid">\r
                                                        <xsl:value-of select="@id" />\r
                                                </xsl:variable>\r
-       \r
+\r
                                <!-- For each section if there is note about availability in this version -->\r
                                                        <xsl:for-each select="refsection">\r
                                                                <xsl:for-each select="para|note">\r