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] Why do formalparas only allow one para?




regards On 07/28/2009 04:02 PM, Kate.Wringe@sybase.com wrote:
>
> As it stands today, there is a usability problem with formalparas--the
> reader is forced to figure out if the paragraph that follows a
> formalpara belongs to the formalpara or not.
>
> The processing instructions
> (http://www.docbook.org/tdg5/en/html/formalpara.html) for formalpara do
> not suggest that formalparas should be visually set apart (e.g.,
> indented, etc.,) from other paras in the output.
> Although it is quite clear that run-in title and para that immediately
> follows the title belong together, there is nothing to suggest how to
> interpret the following paras (and other elements).
>
> The reader (and the writer) must figure out whether or not the paras
> following formalparas belong to the formalpara or not. This problem
> exists even if the writer uses formalparas "properly" and does not
> intend the paras following the formalpara to belong to the formalpara.

Then think of the semantics from the reader viewpoint when he|she is
blind, or using tactile media or audio.

formalpara has one para is easy(ier) to keep in the head.


regards




-- 
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk


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