OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [docbook] Re: Automatic numbering in DocBook


On Wed, 19 Jul 2006 12:39:17 -0400, Norman Walsh <ndw@nwalsh.com> wrote:

> / nico <nicolas.marsgui@libertysurf.fr> was heard to say:
> |> to orderedlist. I tend to think, however, that the number of lines in
> |> a verbatim environment is really a global style issue more than a
> |> case-by-case issue. Why number one program listing every 3 lines,
> |> another every 5 lines, and another every 10 lines *in a single
> |> document*? One case, numbering differently for very short verbatim
> |> environments, is something I think the stylesheets should handle
> |> better, but not by forcing the author to specify it each time.
> |
> | IMHO there are cases where verbatim layout should look differently
> | in the same document. For example, one can have two listing flows,
> | one for some old code implementation (in perl), the other for the
> | new implementation (in python), and it can be interesting to show
> | each flow differently.
>
> Sure, and I'd probably use <programlisting role="perl"> and
> <programlisting role="python"> to distinguish the two kinds of
> listings, but I'd still put the formatting details (perl listings
> formatted this way, python that way) in the stylesheet, not the source
> document.

Ok, role is a handy way to customize things, but you cannot do everything  
with this. There might be some cases where the same kind of programs (say,  
perl) should have a different line numbering. Would you create another  
role, like "perl-short", "perl-long"?

> | I don't see why some global style setting should affect in the same
> | manner <programlisting>, <literallayout>, <screen> or <synopsis>.
>
> Agreed. (Though that may be the case at the moment. :-/)

Regards,
BG


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]