From owner-cvs-all@FreeBSD.ORG  Thu May 22 05:49:18 2003
Return-Path: <owner-cvs-all@FreeBSD.ORG>
Delivered-To: cvs-all@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 62C6D37B401; Thu, 22 May 2003 05:49:18 -0700 (PDT)
Received: from blackhelicopters.org (geburah.blackhelicopters.org
	[209.69.178.18])	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 400AF43F93; Thu, 22 May 2003 05:49:15 -0700 (PDT)
	(envelope-from mwlucas@blackhelicopters.org)
Received: from blackhelicopters.org (mwlucas@localhost [127.0.0.1])
	by blackhelicopters.org (8.12.8/8.12.8) with ESMTP id h4MCnC0Z083278;
	Thu, 22 May 2003 08:49:12 -0400 (EDT)
	(envelope-from mwlucas@blackhelicopters.org)
Received: (from mwlucas@localhost)
	by blackhelicopters.org (8.12.8/8.12.8/Submit) id h4MCnCUL083277;
	Thu, 22 May 2003 08:49:12 -0400 (EDT)
Date: Thu, 22 May 2003 08:49:12 -0400
From: "Michael W . Lucas" <mwlucas@blackhelicopters.org>
To: Tom Rhodes <trhodes@FreeBSD.org>
Message-ID: <20030522084912.B83238@blackhelicopters.org>
References: <200305202012.h4KKCnLI043890@repoman.freebsd.org>
	<20030520225417.X8403@freebsdmall.com>
	<20030521102544.28331639.trhodes@FreeBSD.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20030521102544.28331639.trhodes@FreeBSD.org>;
	from trhodes@FreeBSD.org on Wed, May 21, 2003 at 10:25:44AM -0400
cc: Murray Stokely <murray@FreeBSD.org>
cc: cvs-doc@FreeBSD.org
cc: cvs-all@FreeBSD.org
cc: doc-committers@FreeBSD.org
Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/ports
	chapter.sgml
X-BeenThere: cvs-all@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: CVS commit messages for the entire tree <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 22 May 2003 12:49:18 -0000

On Wed, May 21, 2003 at 10:25:44AM -0400, Tom Rhodes wrote:
> On Tue, 20 May 2003 22:54:17 -0700
> Murray Stokely <murray@FreeBSD.org> wrote:
> 
> > On Tue, May 20, 2003 at 01:12:49PM -0700, Tom Rhodes wrote:
> > >   Fix a screen tag in another part of the chapter.
> > 
> > Why is this a fix?  You inserted a huge gap between two closely
> > related commands.  You cd into a directory, then you run the make
> > command specified.  The two lines should be in one <screen>.
> > 
> > 	 - Murray
> > 
> > Like this :
> >  
> > -	<screen>&prompt.root; <userinput>cd
> >          /usr/ports/<replaceable>directory</replaceable></userinput></screen>
> > -	 <screen>&prompt.root; <userinput>make MASTER_SITE_OVERRIDE= \
> > +	 <screen>&prompt.root; <userinput>cd
> >          /usr/ports/<replaceable>directory</replaceable></userinput>
> > +&prompt.root; <userinput>make MASTER_SITE_OVERRIDE= \
> > 	       ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/
> >          fetch</userinput></screen>
> > 
> > 
> 
> The output looked horrible on my built version.  The original version
> wrapped it in one <screen> tag, and I hoped to make it look a little
> better.  Sorry.

Some docs are ugly because what they document is ugly.  Accuracy is
far more important than appearance.

==ml

-- 
Michael Lucas		mwlucas@FreeBSD.org, mwlucas@BlackHelicopters.org
http://www.BlackHelicopters.org/~mwlucas/

           Absolute OpenBSD:   http://www.AbsoluteOpenBSD.com/