From owner-freebsd-doc@FreeBSD.ORG  Wed Apr 30 02:00:38 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 AEE4A37B401
	for <freebsd-docs@freebsd.org>; Wed, 30 Apr 2003 02:00:38 -0700 (PDT)
Received: from crf-consulting.co.uk (pc-62-31-42-106-hy.blueyonder.co.uk
	[62.31.42.106])	by mx1.FreeBSD.org (Postfix) with ESMTP id A107643FB1
	for <freebsd-docs@freebsd.org>; Wed, 30 Apr 2003 02:00:36 -0700 (PDT)
	(envelope-from nik@crf-consulting.co.uk)
Received: from clan.nothing-going-on.org (clan.nothing-going-on.org
	[192.168.1.20])
	by crf-consulting.co.uk (8.12.3/8.12.3) with ESMTP id h3U90YRf010705;
	Wed, 30 Apr 2003 10:00:34 +0100 (BST)	(envelope-from nik@catkin)
Received: from clan.nothing-going-on.org (localhost [127.0.0.1])
	h3U90YLG041415;	Wed, 30 Apr 2003 10:00:34 +0100 (BST)
	(envelope-from nik@clan.nothing-going-on.org)
Received: (from nik@localhost)
	by clan.nothing-going-on.org (8.12.8/8.12.8/Submit) id h3U90Y82041414;
	Wed, 30 Apr 2003 10:00:34 +0100 (BST)
Date: Wed, 30 Apr 2003 10:00:32 +0100
From: Nik Clayton <nik@freebsd.org>
To: Lucky Green <shamrock@cypherpunks.to>
Message-ID: <20030430090032.GL32395@clan.nothing-going-on.org>
References: <20030428183759.M89408@pakastelohi.cypherpunks.to>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="dfmC41YZQlborXoK"
Content-Disposition: inline
In-Reply-To: <20030428183759.M89408@pakastelohi.cypherpunks.to>
User-Agent: Mutt/1.4i
Organization: FreeBSD Project <URL:http://www.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 09:00:39 -0000


--dfmC41YZQlborXoK
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Mon, Apr 28, 2003 at 06:51:35PM +0200, Lucky Green wrote:
> I am seeing the following errors compiling a modified chapter.sgml file:
>=20
> Lines 2789 - 2792 follow:
> 	<step>
> 	<title>Verify the operating system version</title>
>=20
> 	<para>&man.gbde.4; requires FreeBSD 5.0 or higher.</para>
> 	<screen>&prompt.root; <userinput>uname -r</userinput>
> 	<programlisting>
> 	5.0-RELEASE
> 	</programlisting>
> 	</screen></step>

You don't need the ProgramListing element.  You should also be following
the style guide's indentation rules[1], which would give something like
this:

    <step>
      <title>Verify the operating system version</title>

      <para>&man.gdbe.4; requires FreeBSD 5.0 or higher.</para>

      <screen>&prompt.root; <userinput>uname -r</userinput>
5.0-RELEASE</screen>
    </step>

dependening on how big the initial indent is.

N

[1]
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/writing-style.h=
tml#AEN3228
--=20
FreeBSD: The Power to Serve      http://www.freebsd.org/               (__)
FreeBSD Documentation Project    http://www.freebsd.org/docproj/    \\\'',)
                                                                      \/  \=
 ^
   --- 15B8 3FFC DDB4 34B0 AA5F  94B7 93A8 0764 2C37 E375 ---         .\._/=
_)

--dfmC41YZQlborXoK
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (FreeBSD)

iD8DBQE+r5Cqk6gHZCw343URAq8NAJ4kavDecuOgS1ZBXki4FrW8gXcUrwCeLXWm
5dV9Y3zUw6fOORkvEIxxb48=
=KppN
-----END PGP SIGNATURE-----

--dfmC41YZQlborXoK--