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] | [Elist Home]


Subject: Re: DOCBOOK: <*list> In or After <para>?


At 01:08 PM 8/4/01 +0200, Holger Rauch wrote:

[...]
>There seem to be two choices when it comes to <*list> elements
>(<itemizedlist>, <orderedlist>, etc.).
>
>My questions:
>
>1. Which of the following two ways is the "right" way to do this?
>2. Is it desirable to use <para>s inside <listitem>s or should one try to
>use just <listitem>s (without the <para>s inside)?
[...]

WRT 1, I would argue that both are correct; the list goes inside the 
paragraph if it is logically part of the paragraph, and follows it if it is 
a new thought.  Not a markup issue (except in that the markup should 
support both uses); the question is one for the author and is expressed in 
terms of intent.

My test for this, BTW, is to mentally rewrite the list as a sentence.  If 
that sentence is part of the paragraph, so is the list.  If it starts a new 
paragraph, the list is not part of the paragraph.

Because of this, I find <para> inside <listitem> distracting, and would 
prefer it if they were not needed (for an example of how I would arrange 
things, consider how revision documentation is handled).



Mark B. Wroth
<mark@astrid.upland.ca.us>



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


Powered by eList eXpress LLC