"PROGRAMLISTING", "TITLE" not permitted

[Nik Clayton]

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 ---         .\._/_)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20030430/1c216843/attachment.sig>