booky 0.0.4 → 0.0.6

data/lib/stylesheets/fo/passivetex.xsl

@@ -1,38 +0,0 @@
-<?xml version='1.0' encoding="utf-8"?>
-<xsl:stylesheet exclude-result-prefixes="d"
-                 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-                xmlns:d="http://docbook.org/ns/docbook"
-xmlns:fo="http://www.w3.org/1999/XSL/Format"
-                version='1.0'>
-
-<!-- ********************************************************************
-     $Id: passivetex.xsl 5315 2005-10-20 10:08:42Z kosek $
-     ********************************************************************
-      This extension stops PassiveTeX from merging subsequent '-' to 
-      dashes. You must set passivetex.extensions to '1' if you want get
-      this functionality.
-     ******************************************************************** -->
-
-<xsl:template name="passivetex.dash.subst">
-  <xsl:param name="string"/>
-
-  <xsl:choose>
-    <xsl:when test="contains($string, '--')">
-      <xsl:variable name="rest">
-        <xsl:call-template name="passivetex.dash.subst">
-          <xsl:with-param name="string"
-                          select="concat('-', substring-after($string, '--'))"/>
-        </xsl:call-template>
-      </xsl:variable>
-      <xsl:value-of select="concat(substring-before($string, '--'),
-                                   '-&#x200b;',
-                                   $rest)"/>
-    </xsl:when>
-    <xsl:otherwise>
-      <xsl:value-of select="$string"/>
-    </xsl:otherwise>
-  </xsl:choose>
-</xsl:template>
-
-</xsl:stylesheet>
-

data/lib/stylesheets/fo/pdf2index

@@ -1,140 +0,0 @@
-#!/usr/bin/perl -- # -*- Perl -*-
-
-# this needs some cleanup...
-
-my $PSTOTEXT = "pstotext";
-
-my $pdf = shift @ARGV;
-
-my $index = "";
-my $inindex = 0;
-open (F, "$PSTOTEXT $pdf |");
-while (<F>) {
-    if (/^<\/index/) {
-	$index .= $_;
-	$inindex = 0;
-    }
-    $inindex = 1 if /^<index/;
-
-    if ($inindex) {
-	$index .= $_ if /^\s*</;
-    }
-}
-
-my $cindex = "";
-while ($index =~ /^(.*?)((<phrase role=\"pageno\">.*?<\/phrase>\s*)+)/s) {
-    $cindex .= $1;
-    $_ = $2;
-    $index = $'; # '
-
-    my @pages = m/<phrase role=\"pageno\">.*?<\/phrase>\s*/sg;
-
-    # Expand ranges
-    if ($#pages >= 0) {
-	my @mpages = ();
-	foreach my $page (@pages) {
-	    my $pageno = &pageno($page);
-	    if ($pageno =~ /^([0-9]+)[^0-9]([0-9]+)$/) { # funky -
-		for (my $count = $1; $count <= $2; $count++) {
-		    push (@mpages, "<phrase role=\"$pageno\">$count</phrase>");
-		}
-	    } else {
-		push (@mpages, $page);
-	    }
-	}
-	@pages = sort rangesort @mpages;
-    }
-
-    # Remove duplicates...
-    if ($#pages > 0) {
-	my @mpages = ();
-	my $current = "";
-	foreach my $page (@pages) {
-	    my $pageno = &pageno($page);
-	    if ($pageno ne $current) {
-		push (@mpages, $page);
-		$current = $pageno;
-	    }
-	}
-	@pages = @mpages;
-    }
-
-    # Collapse ranges...
-    if ($#pages > 1) {
-	my @cpages = ();
-	while (@pages) {
-	    my $count = 0;
-	    my $len = &rangelen($count, @pages);
-	    if ($len <= 2) {
-		my $page = shift @pages;
-		push (@cpages, $page);
-	    } else {
-		my $fpage = shift @pages;
-		my $lpage = "";
-		while ($len > 1) {
-		    $lpage = shift @pages;
-		    $len--;
-		}
-		my $fpno = &pageno($fpage);
-		my $lpno = &pageno($lpage);
-		$fpage =~ s/>$fpno</>${fpno}-$lpno</s;
-		push (@cpages, $fpage);
-	    }
-	}
-	@pages = @cpages;
-    }
-
-    my $page = shift @pages;
-    $page =~ s/\s*$//s;
-    $cindex .= $page;
-    while (@pages) {
-	$page = shift @pages;
-	$page =~ s/\s*$//s;
-	$cindex .= ", $page";
-    }
-}
-$cindex .= $index;
-
-print "$cindex\n";
-
-sub pageno {
-    my $page = shift;
-
-    $page =~ s/^<phrase.*?>//;
-    $page =~ s/^<link.*?>//;
-
-    return $1 if $page =~ /^([^<>]+)/;
-    return "?";
-}
-
-sub rangesort {
-    my $apno = &pageno($a);
-    my $bpno = &pageno($b);
-
-    # Make sure roman pages come before arabic ones, otherwise sort them in order
-    return -1 if ($apno !~ /^\d+/ && $bpno =~ /^\d+/);
-    return  1 if ($apno =~ /^\d+/ && $bpno !~ /^\d+/);
-    return $apno <=> $bpno;
-}
-
-sub rangelen {
-    my $count = shift;
-    my @pages = @_;
-    my $len = 1;
-    my $inrange = 1;
-
-    my $current = &pageno($pages[$count]);
-    while ($count < $#pages && $inrange) {
-	$count++;
-	my $next = &pageno($pages[$count]);
-	if ($current + 1 eq $next) {
-	    $current = $next;
-	    $inrange = 1;
-	    $len++;
-	} else {
-	    $inrange = 0;
-	}
-    }
-
-    return $len;
-}

data/lib/stylesheets/fo/pi.xml

@@ -1,1002 +0,0 @@
-<?xml version="1.0"?>
-
-<reference><info><title>FO Processing Instruction Reference</title>
-    <releaseinfo role="meta">
-      $Id: pi.xsl 8487 2009-07-14 21:43:36Z bobstayton $
-    </releaseinfo>
-  </info>
-
-  <partintro xml:id="partintro">
-    <title>Introduction</title>
-
-    
-<para>This is generated reference documentation for all
-      user-specifiable processing instructions (PIs) in the DocBook
-      XSL stylesheets for FO output.
-      <note>
-        
-<para>You add these PIs at particular points in a document to
-          cause specific “exceptions” to formatting/output behavior. To
-          make global changes in formatting/output behavior across an
-          entire document, it’s better to do it by setting an
-          appropriate stylesheet parameter (if there is one).</para>
-
-      </note>
-    </para>
-
-  </partintro>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_background-color">
-<refnamediv>
-<refname>dbfo_background-color</refname>
-<refpurpose>Sets background color for an image</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo background-color="<replaceable>color</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo background-color</tag> PI before or
-      after an image (<tag>graphic</tag>, <tag>inlinegraphic</tag>,
-      <tag>imagedata</tag>, or <tag>videodata</tag> element) as a
-      sibling to the element, to set a background color for the
-      image.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>background-color="<replaceable>color</replaceable>"</term>
-        <listitem>
-          
-<para>An HTML color value</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="BGcolor.html">Background color</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_bgcolor">
-<refnamediv>
-<refname>dbfo_bgcolor</refname>
-<refpurpose>Sets background color on a table row or table cell</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo bgcolor="<replaceable>color</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo bgcolor</tag> PI as child of a table row
-      or cell to set a background color for that table row or cell.</para>
-
-    
-<para>This PI works for both CALS and HTML tables.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>bgcolor="<replaceable>color</replaceable>"</term>
-        <listitem>
-          
-<para>An HTML color value</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="BGtableColor.html#CellBGColor">Cell background color</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_float-type">
-<refnamediv>
-<refname>dbfo_float-type</refname>
-<refpurpose>Specifies float behavior for a sidebar</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo float-type="margin.note"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo float-type</tag> PI to specify the float
-      behavior for a <tag>sidebar</tag> (to cause the sidebar to be
-      displayed as a marginal note).</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>float-type="margin.note"</term>
-        <listitem>
-          
-<para>Specifies that the <tag>sidebar</tag> should be
-            displayed as a marginal note.</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="params"><title>Related Global Parameters</title>
-    
-<para><parameter>sidebar.float.type</parameter> (parameter),
-      <parameter>sidebar.float.width</parameter> (parameter), 
-      <parameter>sidebar.properties</parameter> (attribute-set),
-      <parameter>sidebar.title.properties</parameter> (attribute-set)
-    </para>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="SideFloats.html#SidebarFloats">A sidebar as
-        side float</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_funcsynopsis-style">
-<refnamediv>
-<refname>dbfo_funcsynopsis-style</refname>
-<refpurpose>Specifies presentation style for a funcsynopsis</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo funcsynopsis-style="kr"|"ansi"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo funcsynopsis-style</tag> PI as a child of
-      a <tag>funcsynopsis</tag> or anywhere within a funcsynopsis
-      to control the presentation style for output of all
-      <tag>funcprototype</tag> instances within that funcsynopsis.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>funcsynopsis-style="kr"</term>
-        <listitem>
-          
-<para>Displays <tag>funcprototype</tag> output in K&amp;R style</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry><term>funcsynopsis-style="ansi"</term>
-        <listitem>
-          
-<para>Displays <tag>funcprototype</tag> output in ANSI style</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="params"><title>Related Global Parameters</title>
-    
-<para><parameter>funcsynopsis.style</parameter></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_glossary-presentation">
-<refnamediv>
-<refname>dbfo_glossary-presentation</refname>
-<refpurpose>Specifies presentation style for a glossary</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo glossary-presentation="list"|"blocks"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo glossary-presentation</tag> PI as a child of
-      a <tag>glossary</tag> to control its presentation style.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>glossary-presentation="list"</term>
-        <listitem>
-          
-<para>Displays the glossary as a list</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry><term>glossary-presentation="blocks"</term>
-        <listitem>
-          
-<para>Displays the glossary as blocks</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="params"><title>Related Global Parameters</title>
-    
-<para><parameter>glossary.as.blocks</parameter></para>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="Glossaries.html#GlossaryFormatPrint">Glossary
-        formatting in print</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_glosslist-presentation">
-<refnamediv>
-<refname>dbfo_glosslist-presentation</refname>
-<refpurpose>Specifies presentation style for a glosslist</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo glosslist-presentation="list"|"blocks"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo glosslist-presentation</tag> PI as a child of
-      a <tag>glosslist</tag> to control its presentation style.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>glosslist-presentation="list"</term>
-        <listitem>
-          
-<para>Displays the glosslist as a list</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry><term>glosslist-presentation="blocks"</term>
-        <listitem>
-          
-<para>Displays the glosslist as blocks</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="params"><title>Related Global Parameters</title>
-    
-<para><parameter>glosslist.as.blocks</parameter> </para>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="Glossaries.html#GlossaryFormatPrint">Glossary
-        formatting in print</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_glossterm-width">
-<refnamediv>
-<refname>dbfo_glossterm-width</refname>
-<refpurpose>Specifies the glossterm width for a glossary or
-    glosslist</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo glossterm-width="<replaceable>width</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo glossterm-width</tag> PI as a child of a
-      <tag>glossary</tag> or <tag>glosslist</tag> to specify the
-      width for output of <tag>glossterm</tag> instances in the
-      output.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>glossterm-width="<replaceable>width</replaceable>"</term>
-        <listitem>
-          
-<para>Specifies the glossterm width (including units)</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="params"><title>Related Global Parameters</title>
-    
-<para><parameter>glossterm.width</parameter>,
-      <parameter>glossterm.separation</parameter>
-    </para>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="Glossaries.html#GlossaryFormatPrint">Glossary
-        formatting in print</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_keep-together">
-<refnamediv>
-<refname>dbfo_keep-together</refname>
-<refpurpose>Specifies “keep” behavior for a table, example,
-    figure, equation, procedure, or task</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo keep-together="auto"|"always"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo keep-together</tag> PI as a child of a
-      formal object (<tag>table</tag>, <tag>example</tag>,
-      <tag>figure</tag>, <tag>equation</tag>, <tag>procedure</tag>, or
-      <tag>task</tag>) to specify “keep” behavior (to allow the object to 
-    “break” across a page).</para>
-
-    
-<para>The PI also works with <tag>informaltable</tag>, <tag>informalexample</tag>,
-      <tag>informalfigure</tag> and <tag>informalequation</tag>.
-    </para>
-
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>keep-together="auto"</term>
-        <listitem>
-          
-<para>Enables the object to break across a page</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry><term>keep-together="always"</term>
-        <listitem>
-          
-<para>Prevents the object from breaking across a page (the
-            default stylesheet behavior)</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="params"><title>Related Global Parameters</title>
-    
-<para>formal.object.properties</para>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="PageBreaking.html#KeepTogetherPI">Keep-together processing instruction</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_label-width">
-<refnamediv>
-<refname>dbfo_label-width</refname>
-<refpurpose>Specifies the label width for a qandaset, itemizedlist, orderedlist
-  or calloutlist</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo label-width="<replaceable>width</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo label-width</tag> PI as a child of a
-      <tag>qandaset</tag>, <tag>itemizedlist</tag>, <tag>orderedlist</tag>, 
-      or <tag>calloutlist</tag> to specify the width of labels.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>label-width="<replaceable>width</replaceable>"</term>
-        <listitem>
-          
-<para>Specifies the label width (including units)</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="QandAformat.html">Q and A formatting</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_linenumbering.everyNth">
-<refnamediv>
-<refname>dbfo_linenumbering.everyNth</refname>
-<refpurpose>Specifies interval for line numbers in verbatims</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo linenumbering.everyNth="<replaceable>N</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo linenumbering.everyNth</tag> PI as a child
-      of a “verbatim” element – <tag>programlisting</tag>,
-      <tag>screen</tag>, <tag>synopsis</tag> — to specify
-      the interval at which lines are numbered.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>linenumbering.everyNth="<replaceable>N</replaceable>"</term>
-        <listitem>
-          
-<para>Specifies numbering interval; a number is output
-            before every <replaceable>N</replaceable>th line</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="params"><title>Related Global Parameters</title>
-    
-<para><parameter>linenumbering.everyNth</parameter></para>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="AnnotateListing.html#LineNumbering">Line numbering</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_linenumbering.separator">
-<refnamediv>
-<refname>dbfo_linenumbering.separator</refname>
-<refpurpose>Specifies separator text for line numbers in verbatims</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo linenumbering.separator="<replaceable>text</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo linenumbering.separator</tag> PI as a child
-      of a “verbatim” element – <tag>programlisting</tag>,
-      <tag>screen</tag>, <tag>synopsis</tag> — to specify
-      the separator text output between the line numbers and content.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>linenumbering.separator="<replaceable>text</replaceable>"</term>
-        <listitem>
-          
-<para>Specifies the text (zero or more characters)</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="params"><title>Related Global Parameters</title>
-    
-<para><parameter>linenumbering.separator</parameter></para>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="AnnotateListing.html#LineNumbering">Line numbering</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_linenumbering.width">
-<refnamediv>
-<refname>dbfo_linenumbering.width</refname>
-<refpurpose>Specifies width for line numbers in verbatims</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo linenumbering.width="<replaceable>width</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo linenumbering.width</tag> PI as a child
-      of a “verbatim” element – <tag>programlisting</tag>,
-      <tag>screen</tag>, <tag>synopsis</tag> — to specify
-      the width set aside for line numbers.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>linenumbering.width="<replaceable>width</replaceable>"</term>
-        <listitem>
-          
-<para>Specifies the width (inluding units)</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="params"><title>Related Global Parameters</title>
-    
-<para><parameter>linenumbering.width</parameter></para>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="AnnotateListing.html#LineNumbering">Line numbering</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_list-presentation">
-<refnamediv>
-<refname>dbfo_list-presentation</refname>
-<refpurpose>Specifies presentation style for a variablelist or
-    segmentedlist</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo list-presentation="list"|"blocks"|"table"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo list-presentation</tag> PI as a child of
-      a <tag>variablelist</tag> or <tag>segmentedlist</tag> to
-      control the presentation style for the list (to cause it, for
-      example, to be displayed as a table).</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>list-presentation="list"</term>
-        <listitem>
-          
-<para>Displays the list as a list</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry><term>list-presentation="blocks"</term>
-        <listitem>
-          
-<para>(<tag>variablelist</tag> only) Displays the list as blocks</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry><term>list-presentation="table"</term>
-        <listitem>
-          
-<para>(<tag>segmentedlist</tag> only) Displays the list as a table</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="params"><title>Related Global Parameters</title>
-    
-<itemizedlist>
-      <listitem>
-        
-<para><parameter>variablelist.as.blocks</parameter></para>
-
-      </listitem>
-      <listitem>
-        
-<para><parameter>variablelist.as.table</parameter></para>
-
-      </listitem>
-    </itemizedlist>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="Variablelists.html#ListIndents">Variable list formatting in print</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_list-width">
-<refnamediv>
-<refname>dbfo_list-width</refname>
-<refpurpose>Specifies the width of a horizontal simplelist</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo list-width="<replaceable>width</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo list-width</tag> PI as a child of a
-      <tag>simplelist</tag> whose <tag class="attribute">class</tag>
-      value is <literal>horizontal</literal>, to specify the width
-      of the <tag>simplelist</tag>.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>list-width="<replaceable>width</replaceable>"</term>
-        <listitem>
-          
-<para>Specifies the <tag>simplelist</tag> width (including units)</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_orientation">
-<refnamediv>
-<refname>dbfo_orientation</refname>
-<refpurpose>Specifies the orientation for a CALS table row or cell</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo orientation="0"|"90"|"180"|"270"|"-90"|"-180"|"-270"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo orientation</tag> PI as a child of a CALS
-      <tag>table</tag> row or cell to specify the orientation
-      (rotation) for the row or cell.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>orientation="0"|"90"|"180"|"270"|"-90"|"-180"|"-270"</term>
-        <listitem>
-          
-<para>Specifies the number of degrees by which the cell or
-            row is rotated</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_pgwide">
-<refnamediv>
-<refname>dbfo_pgwide</refname>
-<refpurpose>Specifies if an <tag>equation</tag> or <tag>example</tag> goes across full page width</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo pgwide="0"|"1"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo pgwide</tag> PI as a child of an
-      <tag>equation</tag> or <tag>example</tag> to specify that the
-      content should rendered across the full width of the page.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>pgwide="0"</term>
-        <listitem>
-          
-<para>If zero, the content is rendered across the current
-            text flow</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry><term>pgwide="1"</term>
-        <listitem>
-          
-<para>If <code>1</code> (or any non-zero value), the
-            content is rendered across the full width of the page</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="params"><title>Related Global Parameters</title>
-    
-<para><parameter>pgwide.properties</parameter></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_rotated-width">
-<refnamediv>
-<refname>dbfo_rotated-width</refname>
-<refpurpose>Specifies the width for a CALS table <tag>entry</tag> or
-    <tag>row</tag></refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo rotated-width="<replaceable>width</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo rotated-width</tag> PI as a child of 
-      <tag>entry</tag> or <tag>row</tag> instance in a CALS table to specify the
-      width of that the <tag>entry</tag> or <tag>row</tag>; or
-      use it higher up in table to cause the width to be inherited
-      recursively down.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>rotated-width="<replaceable>width</replaceable>"</term>
-        <listitem>
-          
-<para>Specifies the width of a row or cell (including units)</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_sidebar-width">
-<refnamediv>
-<refname>dbfo_sidebar-width</refname>
-<refpurpose>Specifies the width of a sidebar</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo sidebar-width="<replaceable>width</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo sidebar-width</tag> PI as a child of a
-      <tag>sidebar</tag> to specify the width of the sidebar.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>sidebar-width="<replaceable>width</replaceable>"</term>
-        <listitem>
-          
-<para>Specifies the <tag>sidebar</tag> width (including units)</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="params"><title>Related Global Parameters</title>
-    
-<para><parameter>sidebar.float.type parameter</parameter>,
-      <parameter>sidebar.float.width parameter</parameter>, 
-      <parameter>sidebar.properties attribute-set</parameter>,
-      <parameter>sidebar.title.properties</parameter>
-    </para>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="SideFloats.html#SidebarFloats">A sidebar as
-        side float</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_start">
-<refnamediv>
-<refname>dbfo_start</refname>
-<refpurpose>(obsolete) Sets the starting number on an ordered list</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo start="<replaceable>character</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para><emphasis>This PI is obsolete</emphasis>. The intent of
-      it was to provide a means for setting a specific starting
-      number for an ordered list. Instead of this PI, set a value
-      for the <literal>override</literal> attribute on the first
-      <tag>listitem</tag> in the list; that will have the same
-      effect as what this PI was intended for.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>start="<replaceable>character</replaceable>"</term>
-        <listitem>
-          
-<para>Specifies the character to use as the starting
-            number; use 0-9, a-z, A-Z, or lowercase or uppercase
-            Roman numerals</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="Orderedlists.html#ListStartNum">List starting number</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_table-width">
-<refnamediv>
-<refname>dbfo_table-width</refname>
-<refpurpose>Specifies the width for a CALS table or for revhistory
-    output</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo table-width="<replaceable>width</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo table-width</tag> PI as a child or
-      sibling of a CALS <tag>table</tag>, or as a child of an
-      <tag>informaltable</tag>, <tag>entrytbl</tag>, or
-      <tag>revhistory</tag> instance (which is rendered as a table
-      in output) to specify the width of the table in output.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>table-width="<replaceable>width</replaceable>"</term>
-        <listitem>
-          
-<para>Specifies the table width (including units or as a percentage)</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="Tables.html#TableWidth">Table width</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_term-width">
-<refnamediv>
-<refname>dbfo_term-width</refname>
-<refpurpose>Specifies the term width for a variablelist</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo term-width="<replaceable>width</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo term-width</tag> PI as a child of a
-      <tag>variablelist</tag> to specify the width for
-      <tag>term</tag> output.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>term-width="<replaceable>width</replaceable>"</term>
-        <listitem>
-          
-<para>Specifies the term width (including units)</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="Variablelists.html#ListIndents">Variable list formatting in print</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_toc">
-<refnamediv>
-<refname>dbfo_toc</refname>
-<refpurpose>Specifies whether a TOC should be generated for a qandaset</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo toc="0"|"1"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo toc</tag> PI as a child of a
-      <tag>qandaset</tag> to specify whether a table of contents
-      (TOC) is generated for the <tag>qandaset</tag>.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>toc="0"</term>
-        <listitem>
-          
-<para>If zero, no TOC is generated</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry><term>toc="1"</term>
-        <listitem>
-          
-<para>If <code>1</code> (or any non-zero value),
-            a TOC is generated</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="QandAtoc.html">Q and A list of questions</link>,
-      <link role="tcg" xlink:href="QandAformat.html">Q and A formatting</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo-need">
-<refnamediv>
-<refname>dbfo-need</refname>
-<refpurpose>Specify a need for space (a kind of soft page break)</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo-need height="<replaceable>n</replaceable>" [space-before="<replaceable>n</replaceable>"]</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>A “need” is a request for space on a page.  If the
-      requested space is not available, the page breaks and the
-      content that follows the need request appears on the next
-      page. If the requested space is available, then no page break
-      is inserted.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>height="<replaceable>n</replaceable>"</term>
-        <listitem>
-          
-<para>The amount of height needed (including units)</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry><term>space-before="<replaceable>n</replaceable>"</term>
-        <listitem>
-          
-<para>The amount of extra vertical space to add (including units)</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="PageBreaking.html#SoftPageBreaks">Soft page breaks</link></para>
-
-  </refsect1></refentry>
-
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dbfo_row-height">
-<refnamediv>
-<refname>dbfo_row-height</refname>
-<refpurpose>Specifies the height for a CALS table row</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-
-    <synopsis><tag class="xmlpi">dbfo row-height="<replaceable>height</replaceable>"</tag></synopsis>
-  
-</refsynopsisdiv>
-<refsect1><title>Description</title>
-    
-<para>Use the <tag class="xmlpi">dbfo row-height</tag> PI as a child of a
-      <tag>row</tag> to specify the height of the row.</para>
-
-  </refsect1><refsect1><title>Parameters</title>
-    
-<variablelist>
-      <varlistentry><term>row-height="<replaceable>height</replaceable>"</term>
-        <listitem>
-          
-<para>Specifies the row height (including units)</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1><refsect1 role="tcg"><title>Related Information in <link xlink:href="http://www.sagehill.net/docbookxsl/">DocBook XSL: The Complete Guide</link></title>
-    
-<para><link role="tcg" xlink:href="RowHeight.html">Row height</link></para>
-
-  </refsect1></refentry>
-</reference>
-