[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