Re: Modular Docbook v1.13 bug

[Lionel Mallet <l.mallet@xxxxxxxxxxxxx>]

As promised earlier today, here is my modified version of dbcommon.dsl that 
fixes the TOC numbering problem (at least the way I want it;-).

It also provides additional customisation options to select the format of a 
TOC number for a given element.
The new options are:

	%part-number-format%
	%chapter-number-format%
	%reference-number-format%
	%section-number-format%
	%appendix-number-format%
	%block-number-format%

for which you can specify "A", "I", "i", "a", "1" (any valid value for 
format-number in fact).

Anyway this has just made me think that this was definitely not the right 
solution to solve the TOC numbering problem. For instance the numbering of 
references and chapters currently highly relies on them being in a part within 
a book. If the references or chapters are at the top level, they won't be 
correctly numbered.

Here are some kind of specs for a new implementation that should solve these 
problems.

	1. it should be possible to select between a flat continuous numbering mode or
	   a per-element numbering mode (counters are reset within each element)

	2. it should be possible to specify the TOC format for a given level,
           whatever kind of element is inside

	3. whether an element appears in the TOC and is numbered should only depend
           on its level in the document (maybe with additional filters on 
element type)

	4. any missing requirement?

So the user interface should look like:	

	(define %toc-flat-numbering-depth% 2) ; counters are reset in each element
					      ; at level 2 (levels 1&2 are continuously
					      ; numbered)
	(define ($toc-element-format$ depth)
	   (case depth
		((1) "A")
		((2) "I")
		((3) "1")
		((4) "a")
		(else ""))) ; see $proc-hierarch-number-format$
	(define (toc-element? depth)
	   (case depth
		((1) "num") ; means "in toc and numbered"
		((2) "num")
		((3) "num")
		((4) "toc") ; means "in toc but unnumbered"
		(else ""))) ; means "neither in toc nor numbered"

I would like to have some feedback before I start implementing this spec.

-- 
Lionel Mallet                           E-mail: l.mallet@xxxxxxxxxxxxx
The Open Group Research Institute       Phone: +33 (0) 476 63 48 66
2, Av. de Vignate                       Fax:   +33 (0) 476 51 05 32
F38610 - Gieres, France                 



 DSSSList info and archive:  http://www.mulberrytech.com/dsssl/dssslist