From owner-freebsd-doc@FreeBSD.ORG  Mon Apr 28 16:56:23 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 A38EA37B40A
	for <freebsd-docs@freebsd.org>; Mon, 28 Apr 2003 16:56:23 -0700 (PDT)
Received: from wonkity.com (wonkity.com [65.173.111.5])
	by mx1.FreeBSD.org (Postfix) with ESMTP id E1EFF43FBD
	for <freebsd-docs@freebsd.org>; Mon, 28 Apr 2003 16:56:22 -0700 (PDT)
	(envelope-from wblock@wonkity.com)
Received: from wonkity.com (localhost [127.0.0.1])
	by wonkity.com (8.12.9/8.12.9) with ESMTP id h3SNuJM0029986;
	Mon, 28 Apr 2003 17:56:19 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
	by wonkity.com (8.12.9/8.12.9/Submit) with ESMTP id h3SNuItq029983;
	Mon, 28 Apr 2003 17:56:18 -0600 (MDT)
Date: Mon, 28 Apr 2003 17:56:18 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Lucky Green <shamrock@cypherpunks.to>
In-Reply-To: <20030428183759.M89408@pakastelohi.cypherpunks.to>
Message-ID: <20030428175155.P29905@wonkity.com>
References: <20030428183759.M89408@pakastelohi.cypherpunks.to>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
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: Mon, 28 Apr 2003 23:56:24 -0000

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