From owner-cvs-all@FreeBSD.ORG  Thu Aug  4 07:35:18 2005
Return-Path: <owner-cvs-all@FreeBSD.ORG>
X-Original-To: cvs-all@freebsd.org
Delivered-To: cvs-all@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 914B616A41F;
	Thu,  4 Aug 2005 07:35:18 +0000 (GMT)
	(envelope-from phk@phk.freebsd.dk)
Received: from haven.freebsd.dk (haven.freebsd.dk [130.225.244.222])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 334AD43D45;
	Thu,  4 Aug 2005 07:35:18 +0000 (GMT)
	(envelope-from phk@phk.freebsd.dk)
Received: from phk.freebsd.dk (unknown [192.168.48.2])
	by haven.freebsd.dk (Postfix) with ESMTP id 5A8DEBC66;
	Thu,  4 Aug 2005 07:35:16 +0000 (UTC)
To: Giorgos Keramidas <keramida@freebsd.org>
From: "Poul-Henning Kamp" <phk@phk.freebsd.dk>
In-Reply-To: Your message of "Wed, 03 Aug 2005 20:45:32 +0300."
	<20050803174532.GB14001@beatrix.daedalusnetworks.priv> 
Date: Thu, 04 Aug 2005 09:35:15 +0200
Message-ID: <6523.1123140915@phk.freebsd.dk>
Sender: phk@phk.freebsd.dk
Cc: cvs-src@freebsd.org, src-committers@freebsd.org, cvs-all@freebsd.org
Subject: Re: New NO_XXX knobs 
X-BeenThere: cvs-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: CVS commit messages for the entire tree <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 04 Aug 2005 07:35:18 -0000

In message <20050803174532.GB14001@beatrix.daedalusnetworks.priv>, Giorgos Kera
midas writes:

>Should the following knobs be documented in make.conf(5) too?
>Please, ignore the noise if it's already done or in progress...

Yes, we need to document this better.

There are currently at least three+ places build options are documented:

make.conf(5)
examples/etc/make.conf
various Makefiles

...and none of them are complete.

A new source of information is the output of my build_options survey:

	http://phk.freebsd.dk/misc/build_options/

(still in progress, there are ~200 options to test in total and they
take about 1 hour each.)

Anyone who has time to try to improve the documentation based on
the above information is more than welcome.

-- 
Poul-Henning Kamp       | UNIX since Zilog Zeus 3.20
phk@FreeBSD.ORG         | TCP/IP since RFC 956
FreeBSD committer       | BSD since 4.3-tahoe    
Never attribute to malice what can adequately be explained by incompetence.