From a25787c5495b172ced9fa3999a22aa50ea04e8d0 Mon Sep 17 00:00:00 2001
From: Regina Obe <lr@pcorp.us>
Date: Mon, 1 Oct 2018 05:47:06 +0000
Subject: [PATCH] Add section for 3.0.0 new features. Put a note that
 PostGIS_Extensions_Upgrade() repackages looks functions into postgis_raster
 extension

git-svn-id: http://svn.osgeo.org/postgis/trunk@16852 b70326c6-7e19-0410-871a-916f4a2858ee
---
 doc/reference_management.xml    |   3 +-
 doc/xsl/postgis_aggs_mm.xml.xsl | 101 ++++++++++++++++++++++++++++++++
 2 files changed, 103 insertions(+), 1 deletion(-)

diff --git a/doc/reference_management.xml b/doc/reference_management.xml
index cd8829627..692231331 100644
--- a/doc/reference_management.xml
+++ b/doc/reference_management.xml
@@ -375,7 +375,8 @@ DROP TABLE my_schema.my_spatial_table;
 
 		<para>Availability: 2.5.0</para>
 		<note>
-			<para>Changed: 3.0.0 to support separate postgis_raster extension</para>
+			<para>Changed: 3.0.0 to support separate postgis_raster extension
+				and repackage loose raster functions into postgis_raster.</para>
 		</note>
 	  </refsection>
 
diff --git a/doc/xsl/postgis_aggs_mm.xml.xsl b/doc/xsl/postgis_aggs_mm.xml.xsl
index 3323fae9b..5faff83fa 100644
--- a/doc/xsl/postgis_aggs_mm.xml.xsl
+++ b/doc/xsl/postgis_aggs_mm.xml.xsl
@@ -483,6 +483,107 @@
 
 	   <sect1 id="NewFunctions">
 			<title>New, Enhanced or changed PostGIS Functions</title>
+			<sect2 id="NewFunctions_3_0">
+				<title>PostGIS Functions new or enhanced in 3.0</title>
+				<para>The functions given below are PostGIS functions that were added or enhanced.</para>
+                <xsl:if test="//para[contains(text(),'Availability: 3.0')]">
+				<para>Functions new in PostGIS 3.0</para>
+				<itemizedlist>
+				<!-- Pull out the purpose section for each ref entry and strip whitespace and put in a variable to be tagged unto each function comment  -->
+					<xsl:for-each select='//refentry'>
+						<xsl:sort select="refnamediv/refname"/>
+						<xsl:variable name='comment'>
+							<xsl:value-of select="normalize-space(translate(translate(refnamediv/refpurpose,'&#x0d;&#x0a;', ' '), '&#09;', ' '))"/>
+						</xsl:variable>
+						<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 availability in this version -->
+							<xsl:for-each select="refsection">
+								<xsl:for-each select="para | */para">
+									<xsl:choose>
+										<xsl:when test="contains(.,'Availability: 3.0')">
+											<listitem><simpara><link linkend="{$refid}"><xsl:value-of select="$refname" /></link> - <xsl:value-of select="." /><xsl:text> </xsl:text> <xsl:value-of select="$comment" /></simpara></listitem>
+										</xsl:when>
+									</xsl:choose>
+								</xsl:for-each>
+							</xsl:for-each>
+					</xsl:for-each>
+				</itemizedlist>
+                </xsl:if>
+
+				<xsl:if test="//para[contains(text(),'Enhanced: 3.0')]">
+				<para>Functions enhanced in PostGIS 3.0</para>
+				<itemizedlist>
+				<!-- Pull out the purpose section for each ref entry and strip whitespace and put in a variable to be tagged unto each function comment  -->
+					<xsl:for-each select='//refentry'>
+						<xsl:sort select="refnamediv/refname"/>
+						<xsl:variable name='comment'>
+							<xsl:value-of select="normalize-space(translate(translate(refnamediv/refpurpose,'&#x0d;&#x0a;', ' '), '&#09;', ' '))"/>
+						</xsl:variable>
+						<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 availability in this version -->
+							<xsl:for-each select="refsection">
+								<xsl:for-each select="para | */para">
+									<xsl:choose>
+										<xsl:when test="contains(.,'Enhanced: 3.0')">
+											<listitem><simpara><link linkend="{$refid}"><xsl:value-of select="$refname" /></link> - <xsl:value-of select="." /><xsl:text> </xsl:text> <xsl:value-of select="$comment" /></simpara></listitem>
+										</xsl:when>
+									</xsl:choose>
+								</xsl:for-each>
+							</xsl:for-each>
+					</xsl:for-each>
+				</itemizedlist>
+			</xsl:if>
+
+
+			<para>Functions changed in PostGIS 3.0</para>
+				<xsl:if test="//para[contains(text(),'Changed: 3.0')]">
+				<itemizedlist>
+				<!-- Pull out the purpose section for each ref entry and strip whitespace and put in a variable to be tagged unto each function comment  -->
+					<xsl:for-each select='//refentry'>
+						<xsl:sort select="refnamediv/refname"/>
+						<xsl:variable name='comment'>
+							<xsl:value-of select="normalize-space(translate(translate(refnamediv/refpurpose,'&#x0d;&#x0a;', ' '), '&#09;', ' '))"/>
+						</xsl:variable>
+						<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 availability in this version -->
+							<xsl:for-each select="refsection">
+								<xsl:for-each select="para | */para">
+									<xsl:choose>
+										<xsl:when test="contains(.,'Changed: 3.0')">
+											<listitem><simpara><link linkend="{$refid}"><xsl:value-of select="$refname" /></link> - <xsl:value-of select="." /><xsl:text> </xsl:text> <xsl:value-of select="$comment" /></simpara></listitem>
+										</xsl:when>
+									</xsl:choose>
+								</xsl:for-each>
+							</xsl:for-each>
+					</xsl:for-each>
+				</itemizedlist>
+				</xsl:if>
+			</sect2>
+
             <sect2 id="NewFunctions_2_5">
 				<title>PostGIS Functions new or enhanced in 2.5</title>
 				<para>The functions given below are PostGIS functions that were added or enhanced.</para>
-- 
2.40.0