1 <refentry xmlns="http://docbook.org/ns/docbook"
\r
2 xmlns:xlink="http://www.w3.org/1999/xlink"
\r
3 xmlns:xi="http://www.w3.org/2001/XInclude"
\r
4 xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
\r
5 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
\r
6 version="5.0" xml:id="process.empty.source.toc">
\r
8 <refentrytitle>process.empty.source.toc</refentrytitle>
\r
9 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
\r
12 <refname>process.empty.source.toc</refname>
\r
13 <refpurpose>Generate automated TOC if <tag>toc</tag> element occurs in a source document?</refpurpose>
\r
17 <src:fragment xml:id="process.empty.source.toc.frag"><xsl:param name="process.empty.source.toc" select="0"/></src:fragment>
\r
20 <refsection><info><title>Description</title></info>
\r
22 <para>Specifies that if an empty <tag>toc</tag> element is found in a
\r
23 source document, an automated TOC is generated at this point in the
\r
26 <para>Depending on what the value of the
\r
27 <parameter>generate.toc</parameter> parameter is, setting this
\r
28 parameter to <literal>1</literal> could result in generation of
\r
29 duplicate automated TOCs. So the
\r
30 <parameter>process.empty.source.toc</parameter> is primarily useful
\r
31 as an "override": by placing an empty <tag>toc</tag> in your
\r
32 document and setting this parameter to <literal>1</literal>, you can
\r
33 force a TOC to be generated even if <tag>generate.toc</tag>
\r