Date: Wed, 2 Mar 2005 01:10:26 GMT From: Giorgos Keramidas <keramida@freebsd.org> To: freebsd-doc@FreeBSD.org Subject: Re: docs/76515: missleading use of make -j flag in handbook Message-ID: <200503020110.j221AQcm035621@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/76515; it has been noted by GNATS. From: Giorgos Keramidas <keramida@freebsd.org> To: Tom Rhodes <trhodes@freebsd.org> Cc: bug-followup@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@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> %%%
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200503020110.j221AQcm035621>