From owner-cvs-all Sat Nov 25 9:13:13 2000 Delivered-To: cvs-all@freebsd.org Received: from lists01.iafrica.com (lists01.iafrica.com [196.7.0.141]) by hub.freebsd.org (Postfix) with ESMTP id C84AD37B479 for ; Sat, 25 Nov 2000 09:13:08 -0800 (PST) Received: from nwl.fw.uunet.co.za ([196.31.2.162]) by lists01.iafrica.com with esmtp (Exim 3.12 #2) id 13zisO-0005nT-00; Sat, 25 Nov 2000 19:12:36 +0200 Received: (from nobody@localhost) by nwl.fw.uunet.co.za (8.8.8/8.6.9) id TAA21006; Sat, 25 Nov 2000 19:12:45 +0200 (SAST) Received: by nwl.fw.uunet.co.za via recvmail id 21004; Sat Nov 25 19:12:34 2000 Received: from sheldonh (helo=axl.fw.uunet.co.za) by axl.fw.uunet.co.za with local-esmtp (Exim 3.16 #1) id 13zisL-000B4k-00; Sat, 25 Nov 2000 19:12:33 +0200 From: Sheldon Hearn To: Mike Meyer 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: Your message of "Fri, 24 Nov 2000 13:24:53 CST." <14878.49285.387120.103524@guru.mired.org> Date: Sat, 25 Nov 2000 19:12:33 +0200 Message-ID: <42577.975172353@axl.fw.uunet.co.za> Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Fri, 24 Nov 2000 13:24:53 CST, Mike Meyer wrote: > Is there a document describing which types of things go in man vs the > handbook? I don't think so, no. > I noticed ports(7) and rc.conf(5), which is what made me > decide that man pages were more appropriate than the handbook. I think that ports(7) is information that should have gone into the handbook. I think that rc.conf(5) should be gutted of most of its content, left rather as an explanation of the order in which files are loaded, and valid syntax within the files. That said, I think that the distinction is something many of us are able to make on viewing something, without necessarily being able to delineate it. :-( > 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. > 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. :-) Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message