Date: Wed, 30 Apr 2003 10:00:32 +0100 From: Nik Clayton <nik@freebsd.org> To: Lucky Green <shamrock@cypherpunks.to> Cc: freebsd-docs@freebsd.org Subject: Re: "PROGRAMLISTING", "TITLE" not permitted Message-ID: <20030430090032.GL32395@clan.nothing-going-on.org> In-Reply-To: <20030428183759.M89408@pakastelohi.cypherpunks.to> References: <20030428183759.M89408@pakastelohi.cypherpunks.to>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --]
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:
>
> Lines 2789 - 2792 follow:
> <step>
> <title>Verify the operating system version</title>
>
> <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.html#AEN3228
--
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 --- .\._/_)
[-- Attachment #2 --]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (FreeBSD)
iD8DBQE+r5Cqk6gHZCw343URAq8NAJ4kavDecuOgS1ZBXki4FrW8gXcUrwCeLXWm
5dV9Y3zUw6fOORkvEIxxb48=
=KppN
-----END PGP SIGNATURE-----
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030430090032.GL32395>