From owner-freebsd-doc@FreeBSD.ORG Wed Mar 2 01:10:26 2005 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7ABCA16A4CE for ; Wed, 2 Mar 2005 01:10:26 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 377FD43D39 for ; Wed, 2 Mar 2005 01:10:26 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.1/8.13.1) with ESMTP id j221AQCi035622 for ; Wed, 2 Mar 2005 01:10:26 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.1/8.13.1/Submit) id j221AQcm035621; Wed, 2 Mar 2005 01:10:26 GMT (envelope-from gnats) Date: Wed, 2 Mar 2005 01:10:26 GMT Message-Id: <200503020110.j221AQcm035621@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Giorgos Keramidas Subject: Re: docs/76515: missleading use of make -j flag in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Giorgos Keramidas List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 02 Mar 2005 01:10:26 -0000 The following reply was made to PR docs/76515; it has been noted by GNATS. From: Giorgos Keramidas To: Tom Rhodes 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 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 @@ Run &prompt.root; make buildworld - - It is now possible to specify a option to - make 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. - - On a typical single-CPU machine you would run: - - &prompt.root; make -j4 buildworld - - &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. - - 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. - - 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. %%%