cvs commit: doc/en_US.ISO8859-1/books/handbook/ports chapter.sgml

[Michael W . Lucas]

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 at 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 at FreeBSD.org, mwlucas at BlackHelicopters.org
http://www.BlackHelicopters.org/~mwlucas/

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