From owner-cvs-all Sat Nov 25 10:52:31 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 27C2837B4C5 for ; Sat, 25 Nov 2000 10:52:29 -0800 (PST) Received: (qmail 67490 invoked by uid 100); 25 Nov 2000 18:52:28 -0000 From: Mike Meyer MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <14880.2668.179221.326951@guru.mired.org> Date: Sat, 25 Nov 2000 12:52:28 -0600 (CST) To: Sheldon Hearn , Steve Kargl 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: <42577.975172353@axl.fw.uunet.co.za> References: <42577.975172353@axl.fw.uunet.co.za> <200011251739.eAPHdke20159@troutmask.apl.washington.edu> <14878.49285.387120.103524@guru.mired.org> 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 Steve Kargl types: > Sheldon Hearn wrote: > > > On a larger scale, is there a rational for having these things be two > > > document repositories at all? > > I think that manual pages are designed to document utilities, interfaces, > > formats and drivers. I think that the handbook is designed to document > > more general processes that may or may not include the use of more than > > one utility, interface, driver or format. > This sounds reasonable, except the handbook isn't built and > installed on your system after "make world" while man pages > are. AFAIK, the tools required to buld and read the handbook > are not part of the base system. > > "man rc.conf" brings up a page that can be read. "man handbook" > does not work, "handbook handbook" doesn't work, "info handbook" > does not work. Those are all true (you have to install the docjproj port to get all the tools to build the handbook). I think I mentioned them as reasons for having these things as man pages in the PR that had them. However Sheldon pretty much nailed it on the head: Sheldon Hearn types: > On Fri, 24 Nov 2000 13:24:53 CST, Mike Meyer wrote: > > That's the kind of thing that strikes me as a bad idea without a clear > > and obvious reason for doing so. > You're probably right. Now take a step back and behold the mountain > that you plan to scale. :-) Yup. At the very least, it's a long-term project. The implications for the web site need to be considered as well. However, given that over half my PRs that include fixes, documentation or new code tend to sit ignored for months, I have almost zero inclination to tackle even a small project at this point.