update docs to include breaking function changes, fact that sfcgal now is supported...

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

diff --git a/doc/installation.xml b/doc/installation.xml
index 4fe96d4a8b133b6b3c95bd3c282c20774e8f71a7..3a306712e73952a23b64d71a65347a359a087657 100644 (file)
--- a/doc/installation.xml
+++ b/doc/installation.xml
@@ -18,12 +18,15 @@ make install</programlisting>
        <note><para>The raster support is currently optional, but installed by default. For enabling using the PostgreSQL 9.1+ extensions model raster is required. Using the extension enable process is preferred and more user-friendly. To spatially enable your database:</para></note>
        <programlisting>psql -d yourdatabase -c "CREATE EXTENSION postgis;"
 psql -d yourdatabase -c "CREATE EXTENSION postgis_topology;"
-psql -d yourdatabase -c "CREATE EXTENSION postgis_tiger_geocoder;"</programlisting>
+psql -d yourdatabase -c "CREATE EXTENSION postgis_tiger_geocoder;"
+-- if you built with sfcgal support --
+psql -d yourdatabase -c "CREATE EXTENSION postgis_sfcgal;"
+</programlisting>
        
        
        <para>Please refer to <xref linkend="make_install_postgis_extensions" /> for more details about querying installed/available extensions and upgrading extensions, or switching from a non-extension install to an extension install.</para>
        
-       <para>For those running PostgreSQL 9.0 or who decided for some reason not to compile with raster support, or just are old-fashioned, here are longer more painful instructions for you:</para>
+       <para>For those running who decided for some reason not to compile with raster support, or just are old-fashioned, here are longer more painful instructions for you:</para>
        <para>All the .sql files once installed will be installed in share/contrib/postgis-&last_minor_version; folder
                of your PostgreSQL install</para>
 
@@ -35,7 +38,11 @@ psql -d yourdatabase -f spatial_ref_sys.sql
 psql -d yourdatabase -f rtpostgis.sql
 psql -d yourdatabase -f raster_comments.sql
 psql -d yourdatabase -f topology.sql
-psql -d yourdatabase -f topology_comments.sql</programlisting>
+psql -d yourdatabase -f topology_comments.sql
+--if you built with sfcgal support --
+psql -d yourdatabase -f sfcgal.sql
+psql -d yourdatabase -f sfcgal_comments.sql
+</programlisting>
 
        <para>
          The rest of this chapter goes into detail each of the above installation

diff --git a/doc/xsl/postgis_aggs_mm.xml.xsl b/doc/xsl/postgis_aggs_mm.xml.xsl
index 4baa8fa8f2637acbbf3332d36c754710d6530a11..bd9453260faf5003c52f5406684f3caa38bbdb20 100644 (file)
--- a/doc/xsl/postgis_aggs_mm.xml.xsl
+++ b/doc/xsl/postgis_aggs_mm.xml.xsl
@@ -457,8 +457,7 @@
                                <title>PostGIS Functions new or enhanced in 2.2</title>
                                <para>The functions given below are PostGIS functions that were added or enhanced.</para>
        
-                               <note><para>Tiger Geocoder upgraded to work with TIGER 2013 census data. 
-                                       Please refer to <xref linkend="Tiger_Geocoder" /> for more details.</para></note>
+                               <note><para>postgis_sfcgal now can be installed as an extension using CREATE EXTENSION postgis_sfcgal;</para></note>
                                        
                                <para>Functions new in PostGIS 2.2</para>
                                <itemizedlist>
@@ -491,6 +490,34 @@
                                </itemizedlist>
                        </sect2>
                        
+                <sect2 id="ChangedFunctions_2_2"><title>PostGIS functions breaking changes in 2.2</title>
+                               <para>The functions given below are PostGIS functions that have possibly breaking changes in PostGIS 2.2.  If you use any of these, you may need to check your existing code.</para>
+                               <itemizedlist>
+                               <!-- Pull out the purpose section for each ref entry   -->
+                                       <xsl:for-each select='//refentry'>
+                                               <xsl:sort select="@id"/>
+                                               <xsl:variable name="refid">
+                                                       <xsl:value-of select="@id" />
+                                               </xsl:variable>
+                                               
+                                               <xsl:variable name="refname">
+                                                       <xsl:value-of select="refnamediv/refname" />
+                                               </xsl:variable>
+                               <!-- For each section if there is note about enhanced in this version -->
+                                                       <xsl:for-each select="refsection">
+                                                               <xsl:for-each select="para | */para">
+                                                                       <xsl:choose>
+                                                                               <xsl:when test="contains(.,'Changed: 2.2')">
+                                                                                       <listitem><simpara><link linkend="{$refid}"><xsl:value-of select="$refname" /></link> - <xsl:value-of select="." /></simpara></listitem>
+                                                                               </xsl:when>
+                                                                       </xsl:choose>
+                                                               </xsl:for-each>
+                                                       </xsl:for-each>
+                                       </xsl:for-each>
+                               </itemizedlist>
+                       </sect2>
+
+                       
                        <sect2 id="NewFunctions_2_1">
                                <title>PostGIS Functions new or enhanced in 2.1</title>
                                <para>The functions given below are PostGIS functions that were added or enhanced.</para>