From owner-freebsd-doc Fri Nov 17 16:24:47 2000 Delivered-To: freebsd-doc@freebsd.org Received: from camus.cybercable.fr (camus.cybercable.fr [212.198.0.200]) by hub.freebsd.org (Postfix) with SMTP id 2F67E37B479 for ; Fri, 17 Nov 2000 16:24:43 -0800 (PST) Received: (qmail 4195742 invoked from network); 18 Nov 2000 00:24:42 -0000 Received: from s011.dhcp212-229.cybercable.fr (HELO gits) ([212.198.229.11]) (envelope-sender ) by camus.cybercable.fr (qmail-ldap-1.03) with SMTP for ; 18 Nov 2000 00:24:42 -0000 Original-Sender: Cyrille Lefevre To: Sheldon Hearn Cc: freebsd-doc@FreeBSD.ORG Subject: Re: docs/22676: No man pages for Make.conf or /usr/src/sys/Makefile References: <200011090820.AAA85763@freefall.freebsd.org> X-Face: V|+c;4!|B?E%BE^{E6);aI.[<97Zd*>^#%Y5Cxv;%Y[PT-LW3;A:fRrJ8+^k"e7@+30g0YD0*^^3jgyShN7o?a]C la*Zv'5NA,=963bM%J^o]C In-Reply-To: Sheldon Hearn's message of "Thu, 9 Nov 2000 00:20:01 -0800 (PST)" From: Cyrille Lefevre Reply-To: Cyrille Lefevre Mail-Copies-To: never Date: 12 Nov 2000 16:52:03 +0100 Message-ID: User-Agent: Gnus/5.0807 (Gnus v5.8.7) XEmacs/21.1 (Canyonlands) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Lines: 49 Xref: gits.dyndns.org sent-mail:372 X-Gnus-Article-Number: 372 Sun Nov 12 16:52:05 2000 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Sheldon Hearn writes: > On Wed, 08 Nov 2000 09:30:32 CST, Mike Meyer wrote: > > > First, build(7) doesn't document a single file, but a process. Of > > course, it duplicates information in the files that take place in the > > process - but what man page doesn't duplicate information from the > > sources? > > You're right. I stand down for build(7) (in other words, I think it's a > good idea), but still don't think that make.conf(5) is a good idea. this thread remember me an identical discution in some ml (-current I guess) about the self documentation of /sys/i386/conf/LINT from sources to make it up-to-date. the summary of this, do nothing. for instance, the summary of this thread is... do-nothing. well, from my point of view, we are not going forward this way. consider the newbie point of view. you are saying that there is no one oint of documentation, but many. sometimes, it's there, somethimes, it's out there. while a simple man should suffice. the answer is, one entry point, and the current entry point is not the good one (read /etc/defaults/make.conf). much better is something like this : $ cat /etc/defaults/make.conf # # see make.conf(5) for the description of possible values in the file. # # BDECFLAGS are a set of gcc warning settings that Bruce Evans has suggested # for use in developing FreeBSD and testing changes. They can be used by # putting "CFLAGS+=${BDECFLAGS}" in /etc/make.conf. # BDECFLAGS= -W -Wall -ansi -pedantic -Wbad-function-cast -Wcast-align \ -Wcast-qual -Wchar-subscripts -Wconversion -Winline \ -Wmissing-prototypes -Wnested-externs -Wpointer-arith \ -Wredundant-decls -Wshadow -Wstrict-prototypes -Wwrite-strings $ man make.conf ... that's it. Cyrille. -- home: mailto:clefevre@citeweb.net work: mailto:Cyrille.Lefevre@edf.fr To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message