From owner-cvs-all Sat Nov 25 9:34: 5 2000 Delivered-To: cvs-all@freebsd.org Received: from troutmask.apl.washington.edu (troutmask.apl.washington.edu [128.208.78.105]) by hub.freebsd.org (Postfix) with ESMTP id 938E337B479 for ; Sat, 25 Nov 2000 09:34:03 -0800 (PST) Received: (from sgk@localhost) by troutmask.apl.washington.edu (8.11.1/8.11.1) id eAPHdke20159; Sat, 25 Nov 2000 09:39:46 -0800 (PST) (envelope-from sgk) From: Steve Kargl Message-Id: <200011251739.eAPHdke20159@troutmask.apl.washington.edu> 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> from Sheldon Hearn at "Nov 25, 2000 07:12:33 pm" To: Sheldon Hearn Date: Sat, 25 Nov 2000 09:39:46 -0800 (PST) Cc: Mike Meyer , cvs-all@FreeBSD.ORG X-Mailer: ELM [version 2.4ME+ PL61 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG 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. -- Steve To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message