From owner-freebsd-doc@FreeBSD.ORG  Wed Apr 30 08:59:35 2003
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 4341A37B401
	for <freebsd-docs@freebsd.org>; Wed, 30 Apr 2003 08:59:35 -0700 (PDT)
Received: from eborcom.com (dsl-62-3-122-102.zen.co.uk [62.3.122.102])
	by mx1.FreeBSD.org (Postfix) with SMTP id C605C43FA3
	for <freebsd-docs@freebsd.org>; Wed, 30 Apr 2003 08:59:32 -0700 (PDT)
	(envelope-from tom@FreeBSD.org)
Received: (qmail 20766 invoked by uid 1001); 30 Apr 2003 15:59:30 -0000
Date: Wed, 30 Apr 2003 16:59:30 +0100
From: Tom Hukins <tom@FreeBSD.org>
To: Chris Pepper <pepper@reppep.com>
Message-ID: <20030430155930.GA20596@eborcom.com>
Mail-Followup-To: Tom Hukins <tom@FreeBSD.org>,
	Chris Pepper <pepper@reppep.com>, Nik Clayton <nik@freebsd.org>,
	Lucky Green <shamrock@cypherpunks.to>, freebsd-docs@freebsd.org
References: <20030428183759.M89408@pakastelohi.cypherpunks.to>
	<20030430090032.GL32395@clan.nothing-going-on.org>
	<p06000f03bad57faba77a@[129.85.219.160]>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <p06000f03bad57faba77a@[129.85.219.160]>
User-Agent: Mutt/1.4.1i
cc: Lucky Green <shamrock@cypherpunks.to>
cc: Nik Clayton <nik@freebsd.org>
cc: freebsd-docs@freebsd.org
Subject: Re: "PROGRAMLISTING", "TITLE" not permitted
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 30 Apr 2003 15:59:35 -0000

On Wed, Apr 30, 2003 at 09:28:44AM -0400, Chris Pepper wrote:
> At 10:00 AM +0100 2003/04/30, Nik Clayton wrote:
> 
> >[1]
> >http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/writing-style.html#AEN3228
> 
> 	A good reference, but it confuses me a bit. According to 
> "Content within elements should be indented by two spaces if the 
> content runs over more than one line.", shouldn't the 'which' inside 
> the <emphasis> be indented two more spaces, or should it say "Content 
> within BLOCK elements"?

No, because the content of <emphasis> does not run over more than one
line.

I agree that this particular paragraph could be written more clearly,
though.  I tried to improve it recently, but I don't feel completely
happy with the changes I made.

Tom