From user-return-2277-apmail-forrest-user-archive=forrest.apache.org@forrest.apache.org Wed Jun 22 10:10:16 2005 Return-Path: Delivered-To: apmail-forrest-user-archive@www.apache.org Received: (qmail 35699 invoked from network); 22 Jun 2005 10:10:16 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 22 Jun 2005 10:10:16 -0000 Received: (qmail 74756 invoked by uid 500); 22 Jun 2005 10:10:15 -0000 Delivered-To: apmail-forrest-user-archive@forrest.apache.org Received: (qmail 74712 invoked by uid 500); 22 Jun 2005 10:10:13 -0000 Mailing-List: contact user-help@forrest.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: user@forrest.apache.org List-Id: Delivered-To: mailing list user@forrest.apache.org Received: (qmail 74698 invoked by uid 99); 22 Jun 2005 10:10:13 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 22 Jun 2005 03:10:13 -0700 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests= X-Spam-Check-By: apache.org Received-SPF: neutral (asf.osuosl.org: local policy) Received: from [217.199.181.91] (HELO ns3.wkwyw.net) (217.199.181.91) by apache.org (qpsmtpd/0.29) with SMTP; Wed, 22 Jun 2005 03:10:14 -0700 Received: (qmail 24094 invoked from network); 22 Jun 2005 10:10:14 -0000 Received: from 82-69-78-226.dsl.in-addr.zen.co.uk (HELO ?192.168.0.4?) (82.69.78.226) by ns3.wkwyw.net with SMTP; 22 Jun 2005 10:10:14 -0000 Message-ID: <42B93902.9000908@apache.org> Date: Wed, 22 Jun 2005 11:10:10 +0100 From: Ross Gardler User-Agent: Mozilla Thunderbird 1.0 (Windows/20041206) X-Accept-Language: en-us, en MIME-Version: 1.0 To: user@forrest.apache.org Subject: Re: unordered list References: <42B81635.7040600@apache.org> <42B90D26.7080902@evc.net> In-Reply-To: <42B90D26.7080902@evc.net> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Maurice Lanselle wrote: > Ross Gardler said the following on 21/06/2005 15:29: ... >> (note a paragraph is a group of sentences, so list, ordered or >> otherwise has no place inside a paragraph) >> >> Ross >> > Not everyone would agree that lists (and long quotations) never have > their place in paragraphs. The essence of a paragraph is that it treats > or develops a single point. It may be a short phrase, or even just a > word in a dialogue, or quite long. Discussion of a list's content may > well belong in the same paragraph as its introduction. > >> "The object of treating each topic in a paragraph is, of course, to >> aid the reader. The beginning of each paragraph is a signal to him >> that a new step in the development of the subject has been reached." >> (Strunk and White, "The Elements of Style"). Note the title "Elements of Style", now read on... > The work-around of placing the list between two paragraphs may be > satisfactory, at least when the list begins or ends the paragraph. > However, if the paragraphs are indented, the reader may not easily > recognize that the end of the discussion is the continuation of the same > point. As Strunk and White caution, > >> "But remember, too, that firing off too many paragraphs in quick >> succession can be distracting. Paragraph breaks used only for show >> read like the writing of commerce or of display advertising. >> Moderation and a sense of order should be the main consideration in >> paragraphing." That is a statement about the *display* (or style) of the information not about the contextual *mark-up* of the information. If you want to change the *style* of something being output then you use class attributes:

blah blah

    ...

...

This allows you to format the content appropriately for the given output medium (which is what Forrest is all about) and context. Remember that although this user was writing directly in XDoc this is not requried by Forrest, we support a very wide range of input formats. Of course, you can achieve the same effect with embedded lists, but not with our Documentv2.0. If there is enough demand to do this we will change the DTD accordingly since we are movng towards using a subset of XHTML2 as out intermediate language and XHTML2 allows lists embedded in para's. Ross