From: Norman Walsh <ndw@nwalsh.com>
Date: Sat, 20 Apr 2002 15:01:56 +0000 (+0000)
Subject: Improve documentation
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=53e401253c829547975dac5967fcecb045800e29;p=docbook-dsssl

Improve documentation
---

diff --git a/xsl/params/generate.toc.xml b/xsl/params/generate.toc.xml
index 06d5bfeb6..26393b40c 100644
--- a/xsl/params/generate.toc.xml
+++ b/xsl/params/generate.toc.xml
@@ -46,7 +46,7 @@ path/value pairs. Each path identifies some element in the source document
 using a restricted subset of XPath (only the implicit child axis, no wildcards,
 no predicates). Paths can be either relative or absolute.</para>
 
-<para>When a particular element, the stylesheets consult this table to
+<para>When processing a particular element, the stylesheets consult this table to
 determine if a ToC (or LoT(s)) should be generated.</para>
 
 <para>For example, consider the entry:</para>
@@ -74,5 +74,15 @@ part/article toc</screen>
 so if you want nothing to be generated for articles in parts, you can simply leave
 that rule out.</para>
 
+<para>If you want to leave the rule in, to make it explicit that you're turning
+something off, use the value <quote>nop</quote>. For example, the following
+entry disables ToCs and LoTs for articles:</para>
+
+<screen>article nop</screen>
+
+<para>Do not simply leave the word <quote>article</quote> in the file
+without a matching value. That'd be just begging the silly little
+path/value parser to get confused.</para>
+
 </refsect1>
 </refentry>