Made some minor doc refinements.

diff --git a/xsl/docsrc/pi/pi.xml b/xsl/docsrc/pi/pi.xml
index ac0b65701574c6ff721357784737caa493a3c61c..549873a96297c9b9ae1afb2cdba9006d57c62b7b 100644 (file)
--- a/xsl/docsrc/pi/pi.xml
+++ b/xsl/docsrc/pi/pi.xml
@@ -16,22 +16,18 @@ $Id$
   <year>2003</year>
   <holder>Ji&rcaron;&iacute; Kosek</holder>
 </copyright>
+<abstract>
+  <para>This is technical reference documentation for the DocBook XSL
+  Stylesheets. It documents processing instructions (PIs) recognized by
+  the stylesheets.</para>
+  
+  <para>These PIs can be usually used to change behaviour of stylesheets
+  in a particular place. If you want to change some setting globally it
+  is better to do it via setting appropriate stylesheet
+  parameter if there is such one.</para>
+</abstract>
 </bookinfo>
 
-<preface id="intro">
-<title>Introduction</title>
-
-<para>This is technical reference documentation for the DocBook XSL
-Stylesheets. It documents processing instructions (PIs) recognized by
-the stylesheets.</para>
-
-<para>These PIs can be usually used to change behaviour of stylesheets
-in a particular place. If you want to change some setting globally it
-is better to do it via setting appropriate stylesheet
-parameter if there is such one.</para>
-
-</preface>
-
 <reference id="html">
 <title>HTML PIs</title>
 

diff --git a/xsl/fo/param.xweb b/xsl/fo/param.xweb
index 91301a16988724d95537989c7cfe9f66e6afee9b..e794c62cc5bd544e1f5c63d9cbcae1eb502905b9 100644 (file)
--- a/xsl/fo/param.xweb
+++ b/xsl/fo/param.xweb
@@ -19,16 +19,13 @@ $Id$
   <year>2001</year>
   <holder>Norman Walsh</holder>
 </copyright>
+<abstract>
+  <para>This is reference documentation for all user-configurable
+  parameters in the DocBook XSL FO stylesheets (for generating
+  XSL-FO output destined for final print/PDF output).</para>
+</abstract>
 </bookinfo>
 
-<preface id="intro"><title>Introduction</title>
-
-<para>This is reference documentation for all user-configurable
-parameters in the DocBook XSL FO stylesheets (for generating
-XSL-FO output destined for final print/PDF otutput).</para>
-
-</preface>
-
 <reference id="admons"><title>Admonitions</title>
 &admon.graphics;
 &admon.graphics.extension;

diff --git a/xsl/html/param.xweb b/xsl/html/param.xweb
index 8efa8955d3325ae85ef4f1faa5414ab31020fc76..2b9c288e12b3d488530688b2be869da2cfe8e7c9 100644 (file)
--- a/xsl/html/param.xweb
+++ b/xsl/html/param.xweb
@@ -19,39 +19,13 @@ $Id$
   <year>2001</year>
   <holder>Norman Walsh</holder>
 </copyright>
+<abstract>
+  <para>This is reference documentation for all user-configurable
+  parameters in the DocBook XSL HTML stylesheets (for generating
+  HTML output).</para>
+</abstract>
 </bookinfo>
 
-<preface id="intro"><title>Introduction</title>
-
-<para>This is reference documentation for all user-configurable
-parameters in the DocBook XSL HTML stylesheets (for generating
-HTML output).</para>
-
-<para>This reference describes each of the HTML Stylesheet parameters.
-These are the <quote>easily customizable</quote> parts of the stylesheet.
-If you want to specify an alternate value for one or more of these
-parameters, you can do so in a <quote>driver</quote> stylesheet.</para>
-
-<para>For example, if you want to change the <literal>html.stylesheet</literal>
-to <filename>reference.css</filename>, you might create a driver
-stylesheet like this:</para>
-
-<programlisting><![CDATA[<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-                version='1.0'>
-
-  <xsl:import href="http://docbook.sourceforge.net/release/xsl/snapshot/html/docbook.xsl"/>
-
-  <xsl:param name="html.stylesheet">reference.css</xsl:param>
-
-</xsl:stylesheet>]]></programlisting>
-
-<para>Naturally, you have to change the
-<sgmltag class='attribute'>href</sgmltag> attribute on
-<literal>&lt;xsl:import&gt;</literal> to point to
-<filename>docbook.xsl</filename> on your system. (Or
-<filename>chunk.xsl</filename>, if you're using chunking.)</para>
-</preface>
-
 <reference id="admons"><title>Admonitions</title>
 &admon.graphics.extension;
 &admon.graphics.path;

diff --git a/xsl/lib/lib.xweb b/xsl/lib/lib.xweb
index 41dbe88433e3086a1ca43a7d33f6de68569f067e..e4af1b91209c109c5d70cd1db555e1ba73118541 100644 (file)
--- a/xsl/lib/lib.xweb
+++ b/xsl/lib/lib.xweb
@@ -7,7 +7,7 @@
 <title>XSL Library Template Reference</title>
 <releaseinfo role="cvs">$Id$
 </releaseinfo>
-<corpauthor>DocBook Open Repository Team</corpauthor>
+<corpauthor>The DocBook Project</corpauthor>
 <copyright>
   <year>1999</year>
   <year>2000</year>

diff --git a/xsl/manpages/param.xweb b/xsl/manpages/param.xweb
index 5f461ce0594f06529c0801dbd555231ab7c0971f..16f6a1b7679bf2065f228bd5431a2e7c243fe409 100644 (file)
--- a/xsl/manpages/param.xweb
+++ b/xsl/manpages/param.xweb
@@ -17,17 +17,19 @@
       <year>2005</year>
       <holder>The DocBook Project</holder>
     </copyright>
+    <abstract>
+      <para>This is reference documentation for all user-configurable
+      parameters in the DocBook XSL "manpages" stylesheet (for
+      generating groff/nroff output). Note that the manpages
+      stylesheet is a customization layer of the DocBook XSL HTML
+      stylesheet. Therefore, you can also use a number of <ulink
+      url="http://docbook.sourceforge.net/release/xsl/current/doc/html/index.html"
+      >HTML stylesheet parameters</ulink> to control manpages output
+      (in addition to the manpages-specific parameters listed in this
+      section).</para>
+    </abstract>
   </bookinfo>
 
-  <preface id="preface">
-    <title>Introduction</title>
-
-    <para>This is reference documentation for all user-configurable
-    parameters in the DocBook XSL "manpages" stylesheets (for
-    generating groff/nroff output).</para>
-
-  </preface>
-
   <reference id="general">
   <title>Hyphenation, justification, and breaking</title>
 &man.hyphenate;

diff --git a/xsl/wordml/param.xweb b/xsl/wordml/param.xweb
index 1443b4969aa31fdc2990af23d19cc655cee09848..ded3b2f811a344bf26b25f5f1543b4c7df4af627 100644 (file)
--- a/xsl/wordml/param.xweb
+++ b/xsl/wordml/param.xweb
@@ -19,15 +19,13 @@
       <year>2004</year>
       <holder>Steve Ball</holder>
     </copyright>
+    <abstract>
+      <para>This is reference documentation for all user-configurable
+      parameters in the DocBook WordML Stylesheets (for generating
+      WordML or Apple Pages output).</para>
+    </abstract>
   </bookinfo>
 
-  <preface id="preface">
-    <title>Introduction</title>
-
-    <para>This is technical documentation for the DocBook XSL Stylesheets to produce WordML output (or Apple Pages); it documents the parameters, templates and usage of the stylesheet(s).</para>
-
-    <para>This is not intended to be <quote>user</quote> documentation.  It is provided for developers writing customisation layers for the stylesheets, and for anyone who's interested in <quote>how it works</quote>.</para>
-  </preface>
   <reference id="params">
   <title>Parameters</title>
 &wordml.template;