1
<refentry id="process.empty.source.toc">
3
<refentrytitle>process.empty.source.toc</refentrytitle>
4
<refmiscinfo role="type">boolean</refmiscinfo>
7
<refname>process.empty.source.toc</refname>
8
<refpurpose>Generate automated TOC if <sgmltag>toc</sgmltag> element occurs in a source document?</refpurpose>
12
<src:fragment id='process.empty.source.toc.frag'><xsl:param name="process.empty.source.toc" select="0"/></src:fragment>
15
<refsect1><title>Description</title>
17
<para>Specifies that if an empty <sgmltag>toc</sgmltag> element is
18
found in a source document, an automated TOC is generated.
20
<para>Depending on what the value of the
21
<parameter>generate.toc</parameter> parameter is, setting this
22
parameter to <literal>1</literal> could result in generation of
23
duplicate automated TOCs. So the
24
<parameter>process.empty.source.toc</parameter> is primarily useful
25
as an "override": by placing an empty <sgmltag>toc</sgmltag> in your
26
document and setting this parameter to <literal>1</literal>, you can
27
force a TOC to be generated even if <sgmltag>generate.toc</sgmltag>