From owner-svn-doc-all@FreeBSD.ORG Wed May 7 03:09:35 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id D73B7617; Wed, 7 May 2014 03:09:34 +0000 (UTC) Received: from dmz-mailsec-scanner-6.mit.edu (dmz-mailsec-scanner-6.mit.edu [18.7.68.35]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id DDF5C6AC; Wed, 7 May 2014 03:09:33 +0000 (UTC) X-AuditID: 12074423-f79916d000000c54-1b-5369a3e58c9f Received: from mailhub-auth-4.mit.edu ( [18.7.62.39]) (using TLS with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP id 7C.5B.03156.5E3A9635; Tue, 6 May 2014 23:09:26 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id s4739Ogi019622; Tue, 6 May 2014 23:09:25 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id s4739MiE021703 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Tue, 6 May 2014 23:09:24 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id s4739LGj028190; Tue, 6 May 2014 23:09:21 -0400 (EDT) Date: Tue, 6 May 2014 23:09:21 -0400 (EDT) From: Benjamin Kaduk To: Dru Lavigne Subject: Re: svn commit: r44734 - head/en_US.ISO8859-1/books/handbook/cutting-edge In-Reply-To: <201405011850.s41Iojk5091857@svn.freebsd.org> Message-ID: References: <201405011850.s41Iojk5091857@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrEIsWRmVeSWpSXmKPExsUixG6nrvtscWawQV+6xY+Ph5gsuppULfYs /81ocWPRfiaL3f29zA6sHjM+zWcJYIzisklJzcksSy3St0vgylh1po214KxyxeudTYwNjA9l uhg5OSQETCTaTncwQ9hiEhfurWfrYuTiEBKYzSRxetpbKGcDo8SMnpNMEM5BJokX//6wdDFy ADn1ErNXKoF0swhoSTxc0c4GYrMJqEjMfLMRzBYRUJR4+nUvI0g5s0C2xMnrISBhYYEQiY8r ZzCC2JwCVhK7T2xhAinhFXCQmDiFHyQsJGAp8b53OyuILSqgI7F6/xQWEJtXQFDi5MwnYDYz UM25P9fZJjAKzkKSmoUktYCRaRWjbEpulW5uYmZOcWqybnFyYl5eapGumV5uZoleakrpJkZw 0Loo72D8c1DpEKMAB6MSD2/Hi4xgIdbEsuLK3EOMkhxMSqK8lT2ZwUJ8SfkplRmJxRnxRaU5 qcWHGCU4mJVEeG/qAuV4UxIrq1KL8mFS0hwsSuK8b62tgoUE0hNLUrNTUwtSi2CyMhwcShK8 E4DRKSRYlJqeWpGWmVOCkGbi4AQZzgM0nAmkhre4IDG3ODMdIn+KUVFKnDdqEVBCACSRUZoH 1wtLKq8YxYFeEeZ1BWnnASYkuO5XQIOZgAZzGaeDDC5JREhJNTBu/mmc5f9qok9Wqo1+QPYX yffuHEt37mYzLfA+H6DGu/tsWvhWN9HcndxLeA0jNW0LVv4ze8wh5rz2V7vGU/Melne/ljHU Kb9vCHhXXXNJaWHp3pAtDwXun6pMT+zXrjVVkwxvWi87l687Q4bTtPzy26BFTBf28qnOmBW+ K8vnYf37m1ZOH5RYijMSDbWYi4oTAblHM9cFAwAA Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, imp@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 07 May 2014 03:09:35 -0000 Warner, can you please double-check the facts about make variables? I am not confident I have the new world order correct. On Thu, 1 May 2014, Dru Lavigne wrote: > > Modified: head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Thu May 1 18:12:22 2014 (r44733) > +++ head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Thu May 1 18:50:44 2014 (r44734) > @@ -1396,6 +1396,25 @@ before running "/usr/sbin/freebsd-update > sequence described in > the following procedure. > > + > + It is a good idea to save the output from running > + make to a file. If something goes wrong, a copy of > + the error message can be posted to one of the &os; mailing > + lists. > + > + The easiest way to do this is to use script with a > + parameter that specifies the name of the file to save all > + output to. Do not save the output to > + /tmp as this directory may be cleared at > + next reboot. A better place to save the file is > + /var/tmp. Run this command immediately before rebuilding > + the world, and then type exit when the > + process has finished: > + > + &prompt.root; script /var/tmp/mw.out > +Script started, output file is /var/tmp/mw.out > + > + (I mentioned on IRC that this could be "script /var/tmp/mw.out make buildworld", but only on BSD boxes -- Linux's script(1) has a different syntax. This is more portable as-is, so I don't think we should change it.) > @@ -1597,140 +1620,70 @@ before running "/usr/sbin/freebsd-update > behavior of the Makefile is controlled by > - these variables. These are the same variables as are set in > - /etc/make.conf, and this provides > - another way of setting them. For example: > + variables. These can either be set in > + /etc/make.conf or they can be specified I think we must also mention /etc/src.conf here, in the file entitled "makeworld". > + when using make. For example, this > + variable specifies that profiled libraries > + should not be built: > > &prompt.root; make -DNO_PROFILE target Using the NO_FOO form of variables is highly deprecated at this point, at least in HEAD. (I think we're trying to deprecate it on the other branches, too.) While reviewing some of Warner's commits to look at the current state of things, I saw a comment in src.opts.mk that "Old instances [of NO_FOO] should be removed since they were just to bridge the gap between FreeBSD 4 and FreeBSD 5." The normal way to disable the building of profiled libraries would be to set WITHOUT_PROFILE in /etc/src.conf; I think that -DWITHOUT_PROFILE on the command line should also work, but would like confirmation from Warner. > - is another way of specifying that profiled libraries > - should not be built, and corresponds with the > + It corresponds with this setting in > + /etc/make.conf: > > NO_PROFILE= true # Avoid compiling profiled libraries (Per the above, this is WITHOUT_PROFILE=true in /etc/src.conf. Maybe we should note that it doesn't matter if it's set to true or false of arglebarglepants; the fact that it's set is the only thing that matters. The inverse of WITHOUT_PROFILE is setting WITH_PROFILE explicitly.) > - line in /etc/make.conf. > - [...] > - On a multi-CPU machine using an SMP configured kernel, try > - values between 6 and 10 and see how they speed things > + &prompt.root; make -j4 buildworld > + > + On a multi-CPU machine, try > + values between 6 and 10 to see how they speed things -j10 is suboptimal on a 32-core machine, surely. The last advice I remember seeing on the mailing lists was that the limit was about 1.5 times the number of cores. -Ben > up. > >