From owner-cvs-all Fri Nov 24 11:24:56 2000 Delivered-To: cvs-all@freebsd.org Received: from guru.mired.org (okc-65-26-235-186.mmcable.com [65.26.235.186]) by hub.freebsd.org (Postfix) with SMTP id E6F9E37B4D7 for ; Fri, 24 Nov 2000 11:24:53 -0800 (PST) Received: (qmail 94142 invoked by uid 100); 24 Nov 2000 19:24:53 -0000 From: Mike Meyer MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <14878.49285.387120.103524@guru.mired.org> Date: Fri, 24 Nov 2000 13:24:53 -0600 (CST) To: Sheldon Hearn Cc: cvs-all@freebsd.org Subject: Re: cvs commit: src/share/man/man5 make.conf.5 src/share/man/man7 build.7 In-Reply-To: <359.975049317@axl.fw.uunet.co.za> References: <14878.334.195893.396445@guru.mired.org> <359.975049317@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-cvs-all@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG Sheldon Hearn types: > On Thu, 23 Nov 2000 23:49:02 CST, Mike Meyer wrote: > > As the author of that page, I object to the phrase "saying > > nothing". Yeah, it says nothing to someone who knows what's in it. So > > what? That's true of *every* man page. > I think the issue here is not about whether this stuff should be > documented. I think that this is already better documented in the > handbook, and I think that the handbook is a better medium for conveying > this kind of information. Is there a document describing which types of things go in man vs the handbook? I noticed ports(7) and rc.conf(5), which is what made me decide that man pages were more appropriate than the handbook. On a larger scale, is there a rational for having these things be two document repositories at all? That's the kind of thing that strikes me as a bad idea without a clear and obvious reason for doing so. Thanx,