From a2ef9665090cc6abc1b218e160966474bc6eae92 Mon Sep 17 00:00:00 2001
From: Regina Obe <lr@pcorp.us>
Date: Fri, 27 Jun 2014 21:23:56 +0000
Subject: [PATCH] update docs to include breaking function changes, fact that
sfcgal now is supported as extension, and how to install sfcgal as extension
git-svn-id: http://svn.osgeo.org/postgis/trunk@12692 b70326c6-7e19-0410-871a-916f4a2858ee
---
doc/installation.xml | 13 ++++++++++---
doc/xsl/postgis_aggs_mm.xml.xsl | 31 +++++++++++++++++++++++++++++--
2 files changed, 39 insertions(+), 5 deletions(-)
diff --git a/doc/installation.xml b/doc/installation.xml
index 4fe96d4a8..3a306712e 100644
--- 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 4baa8fa8f..bd9453260 100644
--- 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>
--
2.40.0