From owner-freebsd-doc@FreeBSD.ORG  Tue Apr 29 01:55:52 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 4B1FB37B401
	for <freebsd-docs@freebsd.org>; Tue, 29 Apr 2003 01:55:52 -0700 (PDT)
Received: from Kain.sumuk.de (Kain.sumuk.de [213.221.86.114])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9912543F75
	for <freebsd-docs@freebsd.org>; Tue, 29 Apr 2003 01:55:50 -0700 (PDT)
	(envelope-from vincent@sumuk.de)
Received: from Moses.earth.sol (Moses.earth.sol [192.168.1.1])
	by Kain.sumuk.de (8.12.9/8.12.8) with ESMTP id h3T8tfCu086786;
	Tue, 29 Apr 2003 10:55:41 +0200 (CEST)
	(envelope-from vincent@sumuk.de)
Received: from Moses.earth.sol (localhost.earth.sol [127.0.0.1])
	by Moses.earth.sol (8.12.5/8.12.5) with ESMTP id h3T8te5X047810;
	Tue, 29 Apr 2003 10:55:41 +0200 (CEST)
	(envelope-from vincent@Moses.earth.sol)
Received: (from vincent@localhost)
	by Moses.earth.sol (8.12.5/8.12.5/Submit) id h3T8tdoR047809;
	Tue, 29 Apr 2003 10:55:39 +0200 (CEST)
Date: Tue, 29 Apr 2003 10:55:38 +0200
From: Martin Heinen <martin@sumuk.de>
To: Warren Block <wblock@wonkity.com>
Message-ID: <20030429105538.A46077@sumuk.de>
References: <20030428183759.M89408@pakastelohi.cypherpunks.to>
	<20030428175155.P29905@wonkity.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20030428175155.P29905@wonkity.com>;
	from wblock@wonkity.com on Mon, Apr 28, 2003 at 05:56:18PM -0600
cc: Lucky Green <shamrock@cypherpunks.to>
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
Reply-To: freebsd-docs@freebsd.org
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: Tue, 29 Apr 2003 08:55:52 -0000

On Mon, Apr 28, 2003 at 05:56:18PM -0600, Warren Block wrote:

> 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>

Using two screen elements puts some vertical space
between the lines which looks ugly.

Since the command prompt and the command output appears
on the same screen, only one screen element should be used:

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

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

You could also use <command> to mark up "uname".
Besides userinput tags and replaceable tags, our
documentation does not use additional mark up in
screen elements.

-- 
Marxpitn