From owner-freebsd-doc  Thu May 25  8:40: 7 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
	by hub.freebsd.org (Postfix) with ESMTP id D4D8137C657
	for <freebsd-doc@freebsd.org>; Thu, 25 May 2000 08:40:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id IAA87015;
	Thu, 25 May 2000 08:40:01 -0700 (PDT)
	(envelope-from gnats@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
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-1.0
Subject: docs/18810: Handbook 18.4.2 should refer to /etc/defaults/make.conf
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>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:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu May 25 08:40:01 PDT 2000
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message