From nobody@FreeBSD.ORG  Thu May 25 08:34:27 2000
Return-Path: <nobody@FreeBSD.ORG>
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id EC96437C5B7; Thu, 25 May 2000 08:34:27 -0700 (PDT)
Message-Id: <20000525153427.EC96437C5B7@hub.freebsd.org>
Date: Thu, 25 May 2000 08:34:27 -0700 (PDT)
From: jpmg@eng.cam.ac.uk
Sender: nobody@FreeBSD.ORG
To: freebsd-gnats-submit@FreeBSD.org
Subject: Handbook 18.4.2 should refer to /etc/defaults/make.conf
X-Send-Pr-Version: www-1.0

>Number:         18810
>Category:       docs
>Synopsis:       Handbook 18.4.2 should refer to /etc/defaults/make.conf
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu May 25 08:40:01 PDT 2000
>Closed-Date:    Fri Jun 16 15:02:30 PDT 2000
>Last-Modified:  Fri Jun 16 15:03:19 PDT 2000
>Originator:     Patrick Gosling
>Release:        4.0-RELEASE
>Organization:
Department of Engineering, University of Cambridge
>Environment:
irrelevant
>Description:
The handbook, chapter 18.4.2 refers to /etc/make.conf as if it
contains all the possible configuration options, whereas in fact
for some time, the file /etc/defaults/make.conf has contained such
information, and /etc/make.conf only contains over-rides.

>How-To-Repeat:
Read the handbook while trying to update your machine.
Look at /etc/make.conf .
Feel confused.
8-)
>Fix:
The first two paragraphs of 18.4.2 need rewriting.  Something like
-------snip--------
Examine the file /etc/make.conf , which contains the
default defines for make which will be used when you rebuild your
source.  They are also used every time you use make, so it is a 
good idea to make sure they are set to something sensible for 
your system.

To find out what you can usefully put in this file, look in 
/etc/defaults/make.conf .  Everything in here is by default
commented out.  If you see something that looks useful, then
copy it into /etc/make.conf and remove the comment character.
For a typical user (not a FreeBSD developer), you will probably
want to use the CFLAGS and NOPROFILE lines.
----------snip----------



>Release-Note:
>Audit-Trail:

From: Alexander Langer <alex@big.endian.de>
To: jpmg@eng.cam.ac.uk
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: docs/18810: Handbook 18.4.2 should refer to /etc/defaults/make.conf
Date: Sat, 10 Jun 2000 13:39:26 +0200

 Thus spake jpmg@eng.cam.ac.uk (jpmg@eng.cam.ac.uk):
 
 > The first two paragraphs of 18.4.2 need rewriting.  Something like
 > -------snip--------
 > Examine the file /etc/make.conf , which contains the
 > default defines for make which will be used when you rebuild your
 > source.  They are also used every time you use make, so it is a 
 > good idea to make sure they are set to something sensible for 
 > your system.
 > 
 > To find out what you can usefully put in this file, look in 
 > /etc/defaults/make.conf .  Everything in here is by default
 > commented out.  If you see something that looks useful, then
 > copy it into /etc/make.conf and remove the comment character.
 > For a typical user (not a FreeBSD developer), you will probably
 > want to use the CFLAGS and NOPROFILE lines.
 > ----------snip----------
 
 I suggest something different, such as:
 
 Examine the file /etc/defaults/make.conf, which contains the default
 defines for make which will be used when you rebuild your source.
 They are also used every time you use make, so it is a good idea to
 make sure they are set to something sensible for your system.
 
 If you want to change one or more of the values that are used by make,
 edit the file /etc/make.conf and add the variables with the new values
 here. All variables, that are listed in /etc/make.conf overwrite the
 default values found in /etc/defaults/make.conf.
 
 For a typical user (not a FreeBSD developer), you will probably want
 to use the CFLAGS and NOPROFILE lines.
 
 Example: Add
 
 NOPROFILE=true
 
 to your /etc/make.conf file.
 
 Alex
 -- 
 (Imagine a big "FreeBSD - The Power To Serve" sticker here)
 

From: jpmg@eng.cam.ac.uk
To: alex@big.endian.de
Cc: freebsd-gnats-submit@FreeBSD.ORG, jpmg@eng.cam.ac.uk
Subject: Re: docs/18810: Handbook 18.4.2 should refer to /etc/defaults/make.conf
Date: Mon, 12 Jun 2000 10:02:34 +0100 (BST)

 > I suggest something different, such as:
 > 
 > Examine the file /etc/defaults/make.conf, which contains the default
 > defines for make which will be used when you rebuild your source.
 > They are also used every time you use make, so it is a good idea to
 > make sure they are set to something sensible for your system.
 > 
 > If you want to change one or more of the values that are used by make,
 > edit the file /etc/make.conf and add the variables with the new values
 > here. All variables, that are listed in /etc/make.conf overwrite the
 > default values found in /etc/defaults/make.conf.
 > 
 > For a typical user (not a FreeBSD developer), you will probably want
 > to use the CFLAGS and NOPROFILE lines.
 > 
 > Example: Add
 > 
 > NOPROFILE=true
 > 
 > to your /etc/make.conf file.
 
 Although I can see why you want to change it to that, I think that I
 disagree with it, since:
 
 1) the first paragraph of your suggestion implies (until one has read
    the next paragraph) that the place that one should "set the defines
    to something sensible for your system" is in /etc/defaults/make.conf ,
    since that's all that's been mentioned so far.
 
 2) /etc/defaults/make.conf contains very little that affects the
    behaviour of make, since it's all commented out.  As far as I can
    tell, it is there purely as a form of documentation of what might
    make sense to change.  This isn't what your version implies ...
 
 -patrick.
 
State-Changed-From-To: open->closed 
State-Changed-By: jim 
State-Changed-When: Fri Jun 16 15:02:30 PDT 2000 
State-Changed-Why:  
Committed with minor changes.  Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=18810 
>Unformatted:
