From: Regina Obe <lr@pcorp.us>
Date: Fri, 26 Sep 2008 18:55:43 +0000 (+0000)
Subject: xsl that generates index listing of postgis spatial aggregates and MM compliant functions
X-Git-Tag: 1.4.0b1~697
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=5acaa1a7abee575d204886732a6dfec6a883db3a;p=postgis

xsl that generates index listing of postgis spatial aggregates and MM compliant functions

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

diff --git a/doc/xsl/postgis_aggs_mm.xml.xsl b/doc/xsl/postgis_aggs_mm.xml.xsl
new file mode 100644
index 000000000..2c49a709b
--- /dev/null
+++ b/doc/xsl/postgis_aggs_mm.xml.xsl
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="utf-8"?>
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+<!-- ********************************************************************
+     $Id: 0.1 postgis_mm.xml.xsl 2008-09-26 $
+     ********************************************************************
+	 Copyright 2008, Regina Obe
+     License: BSD
+	 Purpose: This is an xsl transform that generates index listing of aggregate functions and mm /sql compliant functions xml section from reference_new.xml to then
+	 be processed by doc book
+     ******************************************************************** -->
+	<xsl:output method="xml" indent="yes" />
+	<xsl:template match='/chapter'>
+	
+	  <title>PostGIS Aggregates Index</title>
+	  <para>The functions given below are spatial aggregate functions provided with PostGIS that can
+	  be used just like any other sql aggregate function such as sum, average.</para>
+	  <chapter>
+	  <sect1><title>PostGIS Aggregate Functions</title>
+	  	
+		<xsl:variable name="ap"><xsl:text>'</xsl:text></xsl:variable>
+<!-- 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='sect1/refentry'>
+		  <xsl:variable name='comment'>
+		  	<xsl:value-of select="normalize-space(translate(translate(refnamediv/refpurpose,'&#x0d;&#x0a;', ' '), '&#09;', ' '))"/>
+		  </xsl:variable>
+
+<!-- For each function prototype generate the DDL comment statement
+	If its input is a geometry set - we know it is an aggregate function rather than a regular function -->
+			<xsl:for-each select="refsynopsisdiv/funcsynopsis/funcprototype">
+				<xsl:choose>
+					<xsl:when test="contains(paramdef/type,'geometry set')">
+						<p><xref linkend="{funcdef/function}" />(geometry <xsl:call-template name="listparams"><xsl:with-param name="func" select="." /></xsl:call-template>) - <xsl:value-of select='$comment' /></p>
+					</xsl:when>
+				</xsl:choose>
+			</xsl:for-each>
+		</xsl:for-each>
+		</sect1>
+		
+		<sect1><title>PostGIS MM Compliant Functions</title>
+		<para>The functions given below are PostGIS functions that conform to the SQL/MM 3 standard</para>
+<!-- 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='sect1/refentry'>
+		  <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>
+
+<!-- For each function prototype generate the DDL comment statement
+	If its input is a geometry set - we know it is an aggregate function rather than a regular function -->
+			<xsl:for-each select="refsection">
+				<xsl:for-each select="para">
+					<xsl:choose>
+						<xsl:when test="contains(.,'implements the SQL/MM')">
+							<p><xref linkend="{$refid}" /> - <xsl:value-of select='$comment' /></p>
+						</xsl:when>
+					</xsl:choose>
+				</xsl:for-each>
+			</xsl:for-each>
+		</xsl:for-each>
+		</sect1>
+		</chapter>
+	</xsl:template>
+
+	<!--macro to pull out function parameter names so we can provide a pretty arg list prefix for each function -->
+	<xsl:template name="listparams">
+		<xsl:param name="func" />
+		<xsl:for-each select="$func">
+			<xsl:if test="count(paramdef/parameter) &gt; 0">args: </xsl:if>
+			<xsl:for-each select="paramdef">
+				<xsl:choose>
+					<xsl:when test="count(parameter) &gt; 0"> 
+						<xsl:value-of select="parameter" />
+					</xsl:when>
+				</xsl:choose>
+				<xsl:if test="position()&lt;last()"><xsl:text>, </xsl:text></xsl:if>
+			</xsl:for-each>
+			<xsl:if test="count(paramdef/parameter) &gt; 0"> - </xsl:if>
+		</xsl:for-each>	
+	</xsl:template>
+
+</xsl:stylesheet>