Re: DOCBOOK: how global is the "override" attribute on a <listitem>

[Bob Stayton <bobs at caldera dot com>]

On Mon, Sep 02, 2002 at 07:02:20AM -0400, Robert P. J. Day wrote:
> 
>   in the online version of docbook TDG, the example shown for
> <itemizedlist> uses a mark attribute of "opencircle", but overrides
> this mark with the first <listitem> having an override attribute
> of bullet.
> 
>   the formatted output shown immediately below shows *all* bullets,
> and yet the documentation for <listitem> claims that the override
> attribute spceifies the keyword for only *this* specific listitem
> element, not the entire list, which seems to disagree with what is
> shown under <itemizedlist>.
> 
>   comments?

This is a problem of supported mark names.
In the DocBook DTD, the 'mark' and 'override' attributes do
not define a fixed set of names for marks.  The stylesheet
determines which mark names are supported.

The mark names supported for the DocBook XSL stylesheets
for HTML output are the same as those for the CSS property
named 'list-style-type'.  Those are 'disc', 'circle', or
'square'.  The stylesheets also accept 'bullet' for 'disc',
and 'box' for 'square'.  Since 'opencircle' is not
supported, you got the default mark.  If you use mark='circle'
instead, you should get the expected results. 

http://www.sagehill.net/xml/docbookxsl/HtmlOutput.html#ListVariations
documents the list mark options in the stylesheets.

-- 

Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
Caldera International, Inc.                 fax:   (831) 429-1887
                                            email: bobs@caldera.com