docs/76515: missleading use of make -j flag in handbook

[Giorgos Keramidas]

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

From: Giorgos Keramidas <keramida at freebsd.org>
To: Tom Rhodes <trhodes at freebsd.org>
Cc: bug-followup at freebsd.org
Subject: Re: docs/76515: missleading use of make -j flag in handbook
Date: Wed, 2 Mar 2005 03:08:12 +0200

 Tom Rhodes <trhodes at FreeBSD.org> wrote:
 >  Giorgos,
 >  I'm going to remove that line unless you provide me a valid
 >  reason not to.  :)
 
 Please, do.  Removing the suggestion for "make -j" is something I wouldn't
 object to any day.  People who are experienced enough with the build of
 FreeBSD will have no problem using -j, since they are already acquainted
 with Make a lot.
 
 What I would remove is shown below.  Feel free to edit/adopt this as needed:
 
 %%%
 Index: chapter.sgml
 ===================================================================
 RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v
 retrieving revision 1.215
 diff -u -r1.215 chapter.sgml
 --- chapter.sgml	12 Jan 2005 23:56:24 -0000	1.215
 +++ chapter.sgml	2 Mar 2005 01:05:02 -0000
 @@ -960,29 +960,6 @@
  	<para>Run</para>
  
  	<screen>&prompt.root; <userinput>make buildworld</userinput></screen>
 - 
 -        <para>It is now possible to specify a <option>-j</option> option to
 -          <command>make</command> which will cause it to spawn several
 -          simultaneous processes.  This is most useful on multi-CPU machines.
 -          However, since much of the compiling process is IO bound rather
 -          than CPU bound it is also useful on single CPU machines.</para>
 -
 -	<para>On a typical single-CPU machine you would run:</para>
 -	  
 -	  <screen>&prompt.root; <userinput>make -j4 buildworld</userinput></screen>
 -
 -	<para>&man.make.1; will then have up to 4 processes running at any one
 -	  time.  Empirical evidence posted to the mailing lists shows this
 -	  generally gives the best performance benefit.</para>
 -
 -	<para>If you have a multi-CPU machine and you are using an SMP
 -	  configured kernel try values between 6 and 10 and see how they speed
 -	  things up.</para>
 -
 -	<para>Be aware that this is still somewhat experimental, and commits
 -	  to the source tree may occasionally break this feature.  If the
 -	  world fails to compile using this parameter try again without it
 -	  before you report any problems.</para>
        </sect3>
        
        <sect3>
 %%%