Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 28 Apr 2003 17:56:18 -0600 (MDT)
From:      Warren Block <wblock@wonkity.com>
To:        Lucky Green <shamrock@cypherpunks.to>
Cc:        freebsd-docs@freebsd.org
Subject:   Re: "PROGRAMLISTING", "TITLE" not permitted
Message-ID:  <20030428175155.P29905@wonkity.com>
In-Reply-To: <20030428183759.M89408@pakastelohi.cypherpunks.to>
References:  <20030428183759.M89408@pakastelohi.cypherpunks.to>

next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, 28 Apr 2003, Lucky Green wrote:

> I am seeing the following errors compiling a modified chapter.sgml file:
>
> 1)
> /usr/local/bin/jade:/usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml:2789:16:E:
> document type does not allow element "PROGRAMLISTING" here; assuming
> missing "FOOTNOTE" start-tag
>
> 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 can't do a <programlisting> inside a <screen>.  It makes sense; a
program listing is, well, a program listing (presumably printed), while
<screen> is used to show what screen output looks like.  I don't have my
files handy for the right way to do this, but you could do it this way:

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

Actually, I wonder if 5.0-RELEASE should also be wrapped with
<computeroutput> tags...

-Warren Block * Rapid City, South Dakota USA



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030428175155.P29905>