docbook: empty/strange toc entries
Subject:
empty/strange toc entries
From:
"Greg Ferguson" ####@####.####
Date:
24 Jan 2001 20:22:43 -0000
Message-Id: <10101241518.ZM27618@hoop.timonium.sgi.com>
For those following the discussion about the XML-RPC-HOWTO,
we found a strange/empty table of contents entry following
processing, such as (denoted by ">>"):
...
3. XML-RPC vs. Other Protocols
3.1. XML-RPC vs. CORBA
3.2. XML-RPC vs. DCOM
3.3. XML-RPC vs. SOAP
4. Sample API: sumAndDifference
>> 2
5. Using XML-RPC with Perl
...
I ran thru the dsssl processing and found the cuplrit,
an element called "list-element-list" which is a "list of
lists" found in the chunked block.
This element is appended onto the set of toc elements.
In the case of the XML-RPC HOWTO, the list embedded in
section 4 had no title, and hence the label for the item
was empty.
I'm not sure if embedding references to lists inside the
main table of contents is really needed, so I added this
to ldp.dsl:
(define (list-element-list)
;; fixes bug in Table of Contents generation; empty list
'())
which corrects the problem and produces a valid table of contents.
r,
--
Greg Ferguson - s/w engr / mtlhd | gferg at sgi.com
SGI Tech Pubs - http://techpubs.sgi.com/ |
Linux Doc Project - http://www.linuxdoc.org/ | gferg at metalab.unc.edu