From owner-freebsd-doc Fri Nov 10 0:56:55 2000 Delivered-To: freebsd-doc@freebsd.org Received: from guru.mired.org (okc-27-149-77.mmcable.com [24.27.149.77]) by hub.freebsd.org (Postfix) with SMTP id 0CFBF37B4D7 for ; Fri, 10 Nov 2000 00:56:53 -0800 (PST) Received: (qmail 12753 invoked by uid 100); 10 Nov 2000 08:56:46 -0000 From: Mike Meyer MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <14859.47182.605198.1071@guru.mired.org> Date: Fri, 10 Nov 2000 02:56:46 -0600 (CST) To: Sheldon Hearn Cc: Nik Clayton , freebsd-doc@freebsd.org, FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/22676: No man pages for Make.conf or /usr/src/sys/Makefile In-Reply-To: <22691.973845815@axl.fw.uunet.co.za> References: <14859.45721.798233.662850@guru.mired.org> <22691.973845815@axl.fw.uunet.co.za> X-Mailer: VM 6.75 under 21.1 (patch 10) "Capitol Reef" XEmacs Lucid X-face: "5Mnwy%?j>IIV\)A=):rjWL~NB2aH[}Yq8Z=u~vJ`"(,&SiLvbbz2W`;h9L,Yg`+vb1>RG% *h+%X^n0EZd>TM8_IB;a8F?(Fb"lw'IgCoyM.[Lg#r\ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Sheldon Hearn types: > On Fri, 10 Nov 2000 02:32:25 CST, Mike Meyer wrote: > > I haven't seen that mail. It's not attached to the PR. Could you tell > > me where it showed up, or possibly forward it to me? > *grumble* *grumble* It always annoys me when folks mail the responsible > mailing list instead of copying their follow-up to the gnats handler. > I'll get Nik's message into gnats. For now, it's included in this > message. Thank you. To reply to a comment from Nik Clayton: > I understand that keeping them up to date is a chore, but I think as long > as they include a caveat that says something like > > BUGS > > This man page may lag behind the actual contents of the file, please > read the comments in the file for any new functionality. The man page references /etc/defaults/make.conf. And since Nik pointed out the relation to periodic.conf & rc.conf, they could use the same caveat. > then we should be OK. I'm also more than happy to support any committer > whacking you want to do when someone commits to /etc/make.conf without > updating make.conf(5) (and we should probably put a comment in the top of > /etc/make.conf saying exactly that. I hope you meant /etc/defaults/make.conf. /etc/make.conf isn't there until someone creates it post-install. Similar comments would be even more effective in the other file sin /etc/defaults.