From owner-cvs-all Sat Nov 25 20:53:10 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 E61AF37B4C5 for ; Sat, 25 Nov 2000 20:53:07 -0800 (PST) Received: (from sgk@localhost) by troutmask.apl.washington.edu (8.11.1/8.11.1) id eAQ4wkm22336; Sat, 25 Nov 2000 20:58:46 -0800 (PST) (envelope-from sgk) From: Steve Kargl Message-Id: <200011260458.eAQ4wkm22336@troutmask.apl.washington.edu> Subject: Re: cvs commit: src/share/man/man5 make.conf.5 src/share/man/man7 build.7 In-Reply-To: <45083.975213318@axl.fw.uunet.co.za> from Sheldon Hearn at "Nov 26, 2000 06:35:18 am" To: Sheldon Hearn Date: Sat, 25 Nov 2000 20:58: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 Sat, 25 Nov 2000 09:39:46 PST, Steve Kargl wrote: > > > This sounds reasonable, except the handbook isn't built and > > installed on your system after "make world" while man pages > > are. > > In the case of build(7) and possibly make.conf(5), this is generally > useless, since documentation for the new features of the world build (or > the build process, for that matter) won't be installed yet. You've completely missed the point. The Handbook *is not* part of the base system. You can't build it with tools in the base system. You can't easily read it with utilities in the base system. You can't search for topics in the Handbook as easily as you can with "apropos". The Handbook has its place, but it should not prevent the documentation of the system in man pages. > > > "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. > > There's a reference to the handbook in the motd. How much more helpful > can we possibly be! :-) > kargl[201] cat /etc/motd FreeBSD 5.0-CURRENT (C456086-A) #0: Sun Nov 19 17:35:32 GMT 2000 :-) -- Steve To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message