From: Michael Smith Date: Thu, 19 Oct 2006 08:40:35 +0000 (+0000) Subject: Made some minor doc refinements. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=434c8383483167eaf9b5c51d2245fa5d9f6d64eb;p=docbook-dsssl Made some minor doc refinements. --- diff --git a/xsl/docsrc/pi/pi.xml b/xsl/docsrc/pi/pi.xml index ac0b65701..549873a96 100644 --- a/xsl/docsrc/pi/pi.xml +++ b/xsl/docsrc/pi/pi.xml @@ -16,22 +16,18 @@ $Id$ 2003 Jiří Kosek + + This is technical reference documentation for the DocBook XSL + Stylesheets. It documents processing instructions (PIs) recognized by + the stylesheets. + + 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. + - -Introduction - -This is technical reference documentation for the DocBook XSL -Stylesheets. It documents processing instructions (PIs) recognized by -the stylesheets. - -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. - - - HTML PIs diff --git a/xsl/fo/param.xweb b/xsl/fo/param.xweb index 91301a169..e794c62cc 100644 --- a/xsl/fo/param.xweb +++ b/xsl/fo/param.xweb @@ -19,16 +19,13 @@ $Id$ 2001 Norman Walsh + + 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). + -Introduction - -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). - - - Admonitions &admon.graphics; &admon.graphics.extension; diff --git a/xsl/html/param.xweb b/xsl/html/param.xweb index 8efa8955d..2b9c288e1 100644 --- a/xsl/html/param.xweb +++ b/xsl/html/param.xweb @@ -19,39 +19,13 @@ $Id$ 2001 Norman Walsh + + This is reference documentation for all user-configurable + parameters in the DocBook XSL HTML stylesheets (for generating + HTML output). + -Introduction - -This is reference documentation for all user-configurable -parameters in the DocBook XSL HTML stylesheets (for generating -HTML output). - -This reference describes each of the HTML Stylesheet parameters. -These are the easily customizable 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 driver stylesheet. - -For example, if you want to change the html.stylesheet -to reference.css, you might create a driver -stylesheet like this: - - - - - - reference.css - -]]> - -Naturally, you have to change the -href attribute on -<xsl:import> to point to -docbook.xsl on your system. (Or -chunk.xsl, if you're using chunking.) - - Admonitions &admon.graphics.extension; &admon.graphics.path; diff --git a/xsl/lib/lib.xweb b/xsl/lib/lib.xweb index 41dbe8843..e4af1b912 100644 --- a/xsl/lib/lib.xweb +++ b/xsl/lib/lib.xweb @@ -7,7 +7,7 @@ XSL Library Template Reference $Id$ -DocBook Open Repository Team +The DocBook Project 1999 2000 diff --git a/xsl/manpages/param.xweb b/xsl/manpages/param.xweb index 5f461ce05..16f6a1b76 100644 --- a/xsl/manpages/param.xweb +++ b/xsl/manpages/param.xweb @@ -17,17 +17,19 @@ 2005 The DocBook Project + + 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 HTML stylesheet parameters to control manpages output + (in addition to the manpages-specific parameters listed in this + section). + - - Introduction - - This is reference documentation for all user-configurable - parameters in the DocBook XSL "manpages" stylesheets (for - generating groff/nroff output). - - - Hyphenation, justification, and breaking &man.hyphenate; diff --git a/xsl/wordml/param.xweb b/xsl/wordml/param.xweb index 1443b4969..ded3b2f81 100644 --- a/xsl/wordml/param.xweb +++ b/xsl/wordml/param.xweb @@ -19,15 +19,13 @@ 2004 Steve Ball + + This is reference documentation for all user-configurable + parameters in the DocBook WordML Stylesheets (for generating + WordML or Apple Pages output). + - - Introduction - - 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). - - This is not intended to be user documentation. It is provided for developers writing customisation layers for the stylesheets, and for anyone who's interested in how it works. - Parameters &wordml.template;