Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 25 Nov 2000 20:58:46 -0800 (PST)
From:      Steve Kargl <sgk@troutmask.apl.washington.edu>
To:        Sheldon Hearn <sheldonh@uunet.co.za>
Cc:        Mike Meyer <mwm@mired.org>, cvs-all@FreeBSD.ORG
Subject:   Re: cvs commit: src/share/man/man5 make.conf.5 src/share/man/man7 build.7
Message-ID:  <200011260458.eAQ4wkm22336@troutmask.apl.washington.edu>
In-Reply-To: <45083.975213318@axl.fw.uunet.co.za> from Sheldon Hearn at "Nov 26, 2000 06:35:18 am"

next in thread | previous in thread | raw e-mail | index | archive | help
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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200011260458.eAQ4wkm22336>