From owner-freebsd-doc  Mon Feb  4 15:20:26 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id D797E37B41B
	for <freebsd-doc@freebsd.org>; Mon,  4 Feb 2002 15:20:02 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g14NK2w20377;
	Mon, 4 Feb 2002 15:20:02 -0800 (PST)
	(envelope-from gnats)
Date: Mon, 4 Feb 2002 15:20:02 -0800 (PST)
Message-Id: <200202042320.g14NK2w20377@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Martin Heinen <martin@sumuk.de>
Subject: Re: docs/34587: Adding Feedback on the issue
Reply-To: Martin Heinen <martin@sumuk.de>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

The following reply was made to PR docs/34587; it has been noted by GNATS.

From: Martin Heinen <martin@sumuk.de>
To: Tom Rhodes <darklogik@pittgoth.com>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/34587: Adding Feedback on the issue
Date: Tue, 5 Feb 2002 00:19:08 +0100

 On Mon, Feb 04, 2002 at 08:40:04AM -0800, Tom Rhodes wrote:
 
 >  <command>boot <replaceable>kernel.old</replaceable></command>
 >  
 >  I just do not really agree with this line, should whitespace be in the 
 >  actual tags, I think someone pointed out to me that no whitespace should 
 >  exsist here.  Something better would be:
 >  
 >  <command>boot</command> <replaceable>kernel.old</replaceable> or maybe
 >  <command>boot</command> <filename>kernel.old</filename>
 
 According to 'DocBook - The Definitive Guide' <command> describes
 an executable program or a text of a command.  <replaceable> is listed
 as valid content for <command>.
 
 The <medialabel> tag seems similar to <command> (in usage terms) and
 the following example is given:
 
 | ... <medialabel>Backup <replaceable>nn</replaceable></medialabel>
 
 Note that <replaceable> and a space are included in the medialabel
 element.
 
 >  although, the first actually sounds a bit more 'realistic' as kernel.old 
 >  would be a replaceable file, HOWEVER, the 'make install' would mv the 
 >  kernel to kernel.old meaning it would be on the system regardless...
 
 Following the Guide, the content of <command> will be restricted to
 #PCDATA, Replaceable, or InlineGraphic in DocBook 4.0, leaving
 the first example.
 
 >  Anyone with more experiance wish to comment, maybe fill me in what to do 
 >  here ;)
 
 Further comments are welcome too.
 
 Martin
 
 -- 
 Marxpitn

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message