Date: Sat, 25 Nov 2000 19:12:33 +0200 From: Sheldon Hearn <sheldonh@uunet.co.za> To: Mike Meyer <mwm@mired.org> Cc: cvs-all@freebsd.org Subject: Re: cvs commit: src/share/man/man5 make.conf.5 src/share/man/man7 build.7 Message-ID: <42577.975172353@axl.fw.uunet.co.za> In-Reply-To: Your message of "Fri, 24 Nov 2000 13:24:53 CST." <14878.49285.387120.103524@guru.mired.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?42577.975172353>