sqlpostgres 1.2.4

data/tools/rdoc/contrib/xslfo/convert.xsl

@@ -0,0 +1,151 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Id: convert.xsl,v 1.1 2003/10/10 08:00:05 wconrad Exp $ -->
+<!-- $Author: wconrad $ -->
+
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                xmlns:fo="http://www.w3.org/1999/XSL/Format"
+                version="1.0">
+
+  <xsl:include href="utils.xsl"/>
+
+  <xsl:template match="/">
+    <xsl:apply-templates/>
+  </xsl:template>
+
+  <xsl:template match="*">
+    <xsl:copy>
+      <xsl:copy-of select="@*"/>
+      <xsl:apply-templates/>
+    </xsl:copy>
+  </xsl:template>
+
+  <!-- file: name, id -->
+  <xsl:template match="file-list/file">
+    <xsl:element name="file">
+      <xsl:attribute name="id">
+        <xsl:value-of select="generate-id()"/>
+      </xsl:attribute>
+      <xsl:attribute name="name">
+        <xsl:value-of select="file-info/path"/>
+      </xsl:attribute>
+      <xsl:apply-templates/>
+    </xsl:element>
+  </xsl:template>
+
+  <xsl:template match="file-info">
+    <xsl:element name="file-info">
+      <xsl:apply-templates select="*[name() != 'path']"/>
+    </xsl:element>
+  </xsl:template>
+
+  <!-- Class|Module: name, id -->
+  <xsl:template match="Class|Module">
+    <xsl:element name="{name()}">
+      <xsl:attribute name="id">
+        <xsl:value-of select="generate-id()"/>
+      </xsl:attribute>
+      <xsl:for-each select="@*[name() != 'id']">
+        <xsl:copy-of select="."/>
+      </xsl:for-each>
+      <xsl:apply-templates/>
+    </xsl:element>
+  </xsl:template>
+
+  <!-- superclass: href or name -->
+  <xsl:template match="superclass|infile">
+    <xsl:variable name="href">
+      <xsl:call-template name="no-hash-mark">
+        <xsl:with-param name="string" select="a/@href"/>
+      </xsl:call-template>
+    </xsl:variable>
+    <xsl:copy>
+      <xsl:choose>
+        <xsl:when test="string-length($href)">
+          <xsl:attribute name="href">
+            <xsl:value-of select="generate-id(//*[@id = $href])"/>
+          </xsl:attribute>
+        </xsl:when>
+        <xsl:otherwise>
+          <xsl:attribute name="name">
+            <xsl:value-of select="."/>
+          </xsl:attribute>
+        </xsl:otherwise>
+      </xsl:choose>
+    </xsl:copy>
+  </xsl:template>
+  
+  <!-- required-file|included-module: href or name -->
+  <xsl:template match="required-file|included-module">
+    <xsl:variable name="href">
+      <xsl:call-template name="no-hash-mark">
+        <xsl:with-param name="string" select="@href"/>
+      </xsl:call-template>
+    </xsl:variable>
+    <xsl:copy>
+      <xsl:choose>
+        <xsl:when test="string-length($href)">
+          <xsl:attribute name="href">
+            <xsl:value-of select="generate-id(//*[@id = $href])"/>
+          </xsl:attribute>
+        </xsl:when>
+        <xsl:otherwise>
+          <xsl:copy-of select="@name"/>
+        </xsl:otherwise>
+      </xsl:choose>
+    </xsl:copy>
+  </xsl:template>
+  
+  <!-- method: id, source-ref, legacy attributes -->
+  <xsl:template match="method">
+    <xsl:element name="method">
+      <xsl:attribute name="id">
+        <xsl:value-of select="generate-id()"/>
+      </xsl:attribute>
+      <xsl:attribute name="href">
+        <xsl:value-of select="generate-id(source-code-listing)"/>
+      </xsl:attribute>
+      <xsl:for-each select="@*[name() != 'id']">
+        <xsl:copy-of select="."/>
+      </xsl:for-each>
+      <xsl:apply-templates/>
+    </xsl:element>
+  </xsl:template>
+
+  <!-- source-code-listing: id -->
+  <xsl:template match="source-code-listing">
+    <xsl:element name="source-code-listing">
+      <xsl:attribute name="id">
+        <xsl:value-of select="generate-id()"/>
+      </xsl:attribute>
+      <xsl:apply-templates/>
+    </xsl:element>
+  </xsl:template>
+    
+  <!-- Determine type of link, for insertion later into fo:basic-link -->
+  <xsl:template match="description//a">
+    <xsl:variable name="href">
+      <xsl:call-template name="no-hash-mark">
+        <xsl:with-param name="string" select="@href"/>
+      </xsl:call-template>
+    </xsl:variable>
+    <xsl:variable name="target">
+      <xsl:value-of select="generate-id(//*[@id = $href])"/>
+    </xsl:variable>
+    <xsl:element name="a">
+      <xsl:choose>
+        <xsl:when test="string-length($target)">
+          <xsl:attribute name="internal-destination">
+            <xsl:value-of select="$target"/>
+          </xsl:attribute>
+        </xsl:when>
+        <xsl:otherwise>
+          <xsl:attribute name="external-destination">
+            <xsl:value-of select="$href"/>
+          </xsl:attribute>
+        </xsl:otherwise>
+      </xsl:choose>
+      <xsl:apply-templates/>
+    </xsl:element>
+  </xsl:template>
+  
+</xsl:stylesheet>

data/tools/rdoc/contrib/xslfo/demo/README

@@ -0,0 +1,21 @@
+The "rdocfo" script will create XSL-FO output -- by default (i.e.,
+with no command-line arguments) for the RDoc installation itself.
+You need Saxon (the command "saxon" in your path), or you can hack
+the script to use a different XSLT processor.
+
+Assuming "saxon" works, just run:
+
+  rdocfo
+
+and you should end up with a file called "rdoc.fo".
+
+You can also do "rdocfo --help" to see the options available; you can
+use those options to use rdocfo more generally.
+
+
+David Alan Black
+dblack@candle.superlink.net
+
+---------------------------------------------
+$Id: README,v 1.1 2003/10/10 08:00:05 wconrad Exp $
+$Author: wconrad $

data/tools/rdoc/contrib/xslfo/demo/rdocfo

@@ -0,0 +1,99 @@
+#!/usr/local/bin/ruby -w
+#
+# rdocfo
+
+require 'getoptlong'
+require 'tempfile'
+require 'rdoc/rdoc'
+
+def help
+  $stderr.print <<EOM
+
+rdocfo -- utility to semi-automate XSL-FO output from RDoc processor
+          (using Saxon)
+
+Options:
+
+  -d, -dir <directory>
+           specify directory to run RDoc on
+  -f, --xmlfile <filename>
+           use specified RDoc XML file instead of running rdoc
+  -h, --help
+           print this message
+  -i, --interfile <filename>
+           use this intermediate XML file
+  -o, --fofile <filename>
+           specify XSL-FO output file (default: rdoc.fo)
+  -x, --xsldir <directory>
+           specify location of XSL stylesheets
+
+- Defaults are set up to run from rdoc/contrib/xslfo/demo and operate
+on the rdoc installation. 
+
+- Directories and files are assumed to be relative to current directory,
+unless they start with "#{File::Separator}".
+
+EOM
+end
+
+opts = GetoptLong.new(
+		      [ "--dir", "-d", GetoptLong::REQUIRED_ARGUMENT ],
+		      [ "--xsldir", "-x", GetoptLong::REQUIRED_ARGUMENT ],
+		      [ "--xmlfile", "-f", GetoptLong::REQUIRED_ARGUMENT ],
+		      [ "--interfile", "-i", GetoptLong::REQUIRED_ARGUMENT ],
+		      [ "--fofile", "-o", GetoptLong::REQUIRED_ARGUMENT ],
+		      [ "--help", "-h", GetoptLong::NO_ARGUMENT ]
+		      )
+
+opthash = {}
+opts.each {|opt,arg| opthash[opt] = arg}
+
+if opthash["--help"]
+  help
+  exit
+end
+
+# The defaults are as per running this from rdoc/contrib/xslfo/demo.
+rdocdir = opthash["--dir"] || "../../.."
+fofile = opthash["--fofile"] || "rdoc.fo"
+xmlfile = opthash["--xmlfile"]
+interfile = opthash["--interfile"]
+xsldir = opthash["--xsldir"] || "../../../contrib/xslfo"
+
+(fofile,xmlfile,interfile,xsldir) = [fofile, xmlfile, interfile,xsldir].map do |file|
+  if file &&! /^#{File::Separator}/.match(file)
+    Dir.pwd + "/" + file 
+  else
+    file
+  end
+end
+
+Dir.chdir(rdocdir)
+
+out1 = if xmlfile then File.new(xmlfile) else Tempfile.new("out1") end
+out2 = if interfile then File.new(interfile) else Tempfile.new("out2") end
+
+unless xmlfile
+  $stdout = out1
+
+  # Inline version of the rdoc script.
+  begin
+    r = RDoc::RDoc.new
+    r.document(%w{--fmt xml})
+  rescue RDoc::RDocError => e
+    $stderr.puts e.message
+    exit(1)
+  end
+  
+  out1.close(false)
+  out1.open
+end
+
+system "saxon #{out1.path} #{xsldir}/convert.xsl > #{out2.path}"
+
+unless interfile
+  out2.close(false)
+  out2.open
+end
+
+system "saxon #{out2.path} #{xsldir}/rdoc.xsl > #{fofile}"

data/tools/rdoc/contrib/xslfo/fcm.xsl

@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Id: fcm.xsl,v 1.1 2003/10/10 08:00:05 wconrad Exp $ -->
+<!-- $Author: wconrad $ -->
+
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:fo="http://www.w3.org/1999/XSL/Format"
+  version="1.0">
+
+  <!-- Handling for file, Class, or Module, from their
+       respective lists -->
+
+  <xsl:template match="file-list/file|Class|Module">
+    <fo:block space-after="24pt">
+      <xsl:attribute name="id">
+        <xsl:value-of select="@id"/>
+      </xsl:attribute>
+      <xsl:call-template name="hr"/>
+      <fo:inline font-family="monospace" font-weight="bold">
+        <xsl:value-of select="@name"/>
+      </fo:inline>
+      <fo:block start-indent="6pt">
+        <xsl:apply-templates select="*[name() != 'description']"/>
+        <xsl:apply-templates select="*[name() = 'description']"/>
+      </fo:block>
+    </fo:block>
+  </xsl:template>
+
+  <xsl:template match="description">
+    <fo:block space-before="12pt" space-after="6pt" font-weight="bold"
+      start-indent="0pt">
+      <xsl:call-template name="labeled-list">
+        <xsl:with-param name="label">Description</xsl:with-param>
+        <xsl:with-param name="style">normal</xsl:with-param>
+      </xsl:call-template>
+    </fo:block>
+    <fo:block margin-right="36pt" font-size="9pt"
+      text-align="justify">
+      <xsl:apply-templates/>
+    </fo:block>
+  </xsl:template>
+
+  <xsl:template match="file/contents">
+    <fo:block start-indent="0pt">
+      <xsl:apply-templates/>
+    </fo:block>
+  </xsl:template>
+
+  <xsl:template match="Class/contents|Module/contents">
+    <fo:block>
+      <xsl:apply-templates/>
+    </fo:block>
+  </xsl:template>
+
+</xsl:stylesheet>

data/tools/rdoc/contrib/xslfo/files.xsl

@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Id: files.xsl,v 1.1 2003/10/10 08:00:05 wconrad Exp $     -->
+<!-- $Author: wconrad $ -->
+
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:fo="http://www.w3.org/1999/XSL/Format"
+  version="1.0">
+
+  <xsl:template match="file-list">
+    <xsl:call-template name="top-level-file-list">
+      <xsl:with-param name="files" select="./file"/>
+    </xsl:call-template>
+      <xsl:apply-templates select="file">
+      <xsl:sort select="@name"/>
+    </xsl:apply-templates>
+  </xsl:template>
+  
+  <xsl:template match="file-info">
+    <fo:block space-before="18pt" start-indent="0pt">
+      <xsl:call-template name="labeled-list">
+        <xsl:with-param name="label">Created</xsl:with-param>
+        <xsl:with-param name="items" select="dtm-created"/>
+      </xsl:call-template>
+      <xsl:call-template name="labeled-list">
+        <xsl:with-param name="label">Modified</xsl:with-param>
+        <xsl:with-param name="items" select="dtm-modified"/>
+      </xsl:call-template>
+    </fo:block>
+  </xsl:template>
+
+  <xsl:template match="required-file-list">
+    <xsl:call-template name="labeled-list">
+      <xsl:with-param name="label">Required files</xsl:with-param>
+      <xsl:with-param name="items" select="required-file"/>
+    </xsl:call-template>
+  </xsl:template>
+
+  <xsl:template name="top-level-file-list">
+    <xsl:param name="files"/>
+    <fo:block break-before="page" break-after="page">
+      <fo:block font-size="18pt" font-family="Helvetica" space-after="18pt">
+        <xsl:text>Files</xsl:text>
+      </fo:block>
+      <fo:block font-family="monospace">
+        <xsl:for-each select="$files">
+          <xsl:sort select="@name"/>
+          <fo:block start-indent="18pt">
+            <fo:inline>
+              <fo:basic-link color="purple">
+                <xsl:attribute name="internal-destination">
+                  <xsl:value-of select="@id"/>
+                </xsl:attribute>
+                <xsl:apply-templates select="@name"/>
+              </fo:basic-link>
+            </fo:inline>
+          </fo:block>
+        </xsl:for-each>
+      </fo:block>
+    </fo:block>
+  </xsl:template>
+
+</xsl:stylesheet>

data/tools/rdoc/contrib/xslfo/labeled-lists.xsl

@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--  $Id: labeled-lists.xsl,v 1.1 2003/10/10 08:00:05 wconrad Exp $ -->
+<!--  $Author: wconrad $ -->
+
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:fo="http://www.w3.org/1999/XSL/Format"
+  version="1.0">
+
+  <!-- 
+       The labeled-list template handles a lot of the work.
+
+       Each item in the node-list $items has a @name
+       and/or an @href.  If it has an @href and no @name,
+       then the name comes from the name of the thing ref'd to.
+       (Failing that, it comes from the item contents itself.) 
+       The @href value is used for the internal-destination
+       of the <fo:basic-link>.
+
+-->
+
+  <xsl:template name="labeled-list">
+    <xsl:param name="label"/>
+    <xsl:param name="labellee"/>
+    <xsl:param name="items"/>
+    <xsl:param name="style" select="'italic'"/>
+      <xsl:if test="$label">
+    <fo:block start-indent="0pt">
+      <fo:inline>
+        <xsl:attribute name="font-style">
+          <xsl:value-of select="$style"/>
+        </xsl:attribute>
+        <xsl:value-of select="concat($label,': ')"/>
+      </fo:inline>
+      <xsl:if test="$labellee">
+        <xsl:apply-templates select="$labellee"/>
+      </xsl:if>
+    </fo:block>
+      </xsl:if>
+    <xsl:if test="$items">
+      <xsl:for-each select="$items">
+        <xsl:sort select="@name"/>
+        <xsl:sort select="@name|key('id',@href)/@name"/>
+        <xsl:variable name="name" select="@name|key('id',@href)/@name"/>
+        <fo:block font-family="monospace" start-indent="12pt">
+          <xsl:choose>
+            <xsl:when test="@href">
+            <fo:basic-link color="purple">
+              <xsl:attribute name="internal-destination">
+                <xsl:value-of select="@href"/>
+              </xsl:attribute>
+              <xsl:value-of select="$name"/>
+            </fo:basic-link>
+          </xsl:when>
+          <xsl:when test="string-length($name)">
+            <xsl:value-of select="$name"/>
+          </xsl:when>
+          <xsl:otherwise>
+            <xsl:value-of select="."/>
+          </xsl:otherwise>
+          </xsl:choose>
+        </fo:block>
+      </xsl:for-each>
+    </xsl:if>
+  </xsl:template>
+  
+</xsl:stylesheet>

data/tools/rdoc/contrib/xslfo/lists.xsl

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Id: lists.xsl,v 1.1 2003/10/10 08:00:05 wconrad Exp $     -->
+<!-- $Author: wconrad $ -->
+
+<xsl:stylesheet
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
+  xmlns:fo="http://www.w3.org/1999/XSL/Format">
+
+  <xsl:template match="ul">
+    <fo:block start-indent="0pt">
+      <fo:list-block margin-left="18pt" space-after="12pt" margin-right="36pt"
+        provisional-distance-between-starts="18pt"
+        provisional-label-separation="9pt">
+        <xsl:apply-templates select="li"/>
+      </fo:list-block>
+    </fo:block>
+  </xsl:template>
+  
+  <xsl:template match="method/description/ul">
+    <fo:block start-indent="0pt">
+      <fo:list-block margin-left="48pt" space-after="12pt" margin-right="36pt"
+        provisional-distance-between-starts="18pt"
+        provisional-label-separation="9pt">
+        <xsl:apply-templates select="li"/>
+      </fo:list-block>
+    </fo:block>
+  </xsl:template>
+  
+  <xsl:template match="li">
+    <fo:list-item>
+      <fo:list-item-label end-indent="label-end()">
+        <fo:block text-align="start">
+          <xsl:text>&#x2022;</xsl:text>
+        </fo:block>
+      </fo:list-item-label>
+      <fo:list-item-body>
+        <fo:block font-weight="normal" space-after="3pt">
+          <xsl:apply-templates/>
+        </fo:block>
+      </fo:list-item-body>
+    </fo:list-item>
+  </xsl:template>
+  
+</xsl:stylesheet>

data/tools/rdoc/contrib/xslfo/modules.xsl

@@ -0,0 +1,152 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--  $Id: modules.xsl,v 1.1 2003/10/10 08:00:05 wconrad Exp $     -->
+<!--  $Author: wconrad $ -->
+
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:fo="http://www.w3.org/1999/XSL/Format"
+  version="1.0">
+
+  <xsl:template match="class-module-list">
+    <xsl:call-template name="c-or-m-list">
+      <xsl:with-param name="label">Classes</xsl:with-param>
+      <xsl:with-param name="items" select="Class"/>
+    </xsl:call-template>
+    <xsl:call-template name="c-or-m-list">
+      <xsl:with-param name="label">Modules</xsl:with-param>
+      <xsl:with-param name="items" select="Module"/>
+    </xsl:call-template>
+  </xsl:template>
+
+  <xsl:template name="c-or-m-list">
+    <xsl:param name="items"/>
+    <xsl:param name="label"/>
+    <xsl:call-template name="top-level-cm-list">
+      <xsl:with-param name="label" select="$label"/>
+      <xsl:with-param name="items" select="$items"/>
+    </xsl:call-template>
+    <xsl:apply-templates select="$items">
+      <xsl:sort select="@name"/>
+    </xsl:apply-templates>
+    <xsl:call-template name="source-code">
+      <xsl:with-param name="label" select="$label"/>
+      <xsl:with-param name="method-list" select="$items/contents/method-list"/>
+    </xsl:call-template>
+  </xsl:template>
+
+  <xsl:template match="classmod-info">
+    <fo:block space-before="18pt">
+      <xsl:call-template name="labeled-list">
+        <xsl:with-param name="label">Defined in</xsl:with-param>
+        <xsl:with-param name="items" select="./infiles/infile"/>
+      </xsl:call-template>
+      <xsl:if test="superclass">
+      <xsl:call-template name="labeled-list">
+        <xsl:with-param name="label">Superclass</xsl:with-param>
+        <xsl:with-param name="items" select="superclass"/>
+      </xsl:call-template>
+      </xsl:if>
+    </fo:block>
+  </xsl:template>
+
+  <xsl:template match="included-module-list">
+    <xsl:call-template name="labeled-list">
+      <xsl:with-param name="label">Included modules</xsl:with-param>
+      <xsl:with-param name="items" select="./included-module"/>
+    </xsl:call-template>
+  </xsl:template>
+
+  <xsl:template match="method-list">
+    <xsl:call-template name="labeled-list">
+      <xsl:with-param name="label">Methods</xsl:with-param>
+    </xsl:call-template>
+    <xsl:apply-templates select="method"/>
+  </xsl:template>
+
+  <xsl:template name="top-level-cm-list">
+    <xsl:param name="label"/>
+    <xsl:param name="items"/>
+    <fo:block break-before="page" break-after="page">
+      <fo:block font-size="18pt" font-family="Helvetica" space-after="18pt">
+        <xsl:value-of select="$label"/>
+      </fo:block>
+      <fo:block font-family="monospace">
+        <xsl:for-each select="$items">
+          <xsl:sort select="@name"/>
+          <fo:block start-indent="18pt">
+              <fo:basic-link color="purple">
+                <xsl:attribute name="internal-destination">
+                  <xsl:value-of select="@id"/>
+                </xsl:attribute>
+                <xsl:apply-templates select="@name"/>
+              </fo:basic-link>
+          </fo:block>
+        </xsl:for-each>
+      </fo:block>
+    </fo:block>
+  </xsl:template>
+
+  <xsl:template match="method">
+    <xsl:call-template name="labeled-list">
+      <xsl:with-param name="items" select="."/>
+    </xsl:call-template>
+    <xsl:if test="description">
+      <xsl:apply-templates select="description"/>
+    </xsl:if>
+  </xsl:template>
+
+  <xsl:template match="methodx">
+    <fo:block start-indent="12pt">
+      <fo:basic-link color="purple">
+        <xsl:attribute name="internal-destination">
+          <xsl:value-of select="@href"/>
+        </xsl:attribute>
+        <fo:inline font-family="monospace">    
+        <xsl:value-of select="@name"/>
+      </fo:inline>
+    </fo:basic-link>
+  </fo:block>
+  <xsl:if test="description">
+    <xsl:apply-templates select="description"/>
+  </xsl:if>
+</xsl:template>
+
+  <xsl:template match="attribute-list">
+    <xsl:variable name="read" select="./attribute[attribute-rw = 'R']"/>
+    <xsl:variable name="rw" select="./attribute[attribute-rw = 'W']"/>
+    <xsl:if test="$read">
+      <xsl:call-template name="labeled-list">
+        <xsl:with-param name="label" select="'Attributes (read-only)'"/>
+      </xsl:call-template>
+      <xsl:apply-templates select="$read">
+        <xsl:sort select="@name"/>
+      </xsl:apply-templates>
+    </xsl:if>
+    <xsl:if test="$rw">
+      <xsl:call-template name="labeled-list">
+        <xsl:with-param name="label" select="'Attributes (read/write)'"/>
+      </xsl:call-template>
+      <xsl:apply-templates select="$rw">
+        <xsl:sort select="@name"/>
+      </xsl:apply-templates>
+    </xsl:if>
+  </xsl:template>
+
+  <xsl:template match="attribute">
+    <fo:block start-indent="18pt">
+      <fo:block font-family="monospace">    
+        <xsl:value-of select="@name"/>
+      </fo:block>
+      <xsl:if test="description">
+        <xsl:apply-templates select="description"/>
+      </xsl:if>
+    </fo:block>
+  </xsl:template>
+
+  <xsl:template match="attribute/description|method/description">
+    <fo:block start-indent="12pt" end-indent="48pt" 
+      font-size="9pt" font-style="italic">
+      <xsl:apply-templates/>
+    </fo:block>
+  </xsl:template>
+
+</xsl:stylesheet>