From owner-freebsd-questions Wed Jul 26 2:19:20 2000 Delivered-To: freebsd-questions@freebsd.org Received: from ns1.sunesi.net (ns1.sunesi.net [196.15.192.194]) by hub.freebsd.org (Postfix) with ESMTP id 25B4B37BE77; Wed, 26 Jul 2000 02:19:14 -0700 (PDT) (envelope-from nbm@sunesi.net) Received: from nbm by ns1.sunesi.net with local (Exim 3.03 #1) id 13HNL5-0007bJ-00; Wed, 26 Jul 2000 11:18:55 +0200 Date: Wed, 26 Jul 2000 11:18:55 +0200 From: Neil Blakey-Milner To: Simon J Mudd Cc: freebsd-questions@freebsd.org, Ben Smithurst Subject: Re: /usr/share/doc/handbook/* updated with cvs? Message-ID: <20000726111855.A29061@mithrandr.moria.org> References: <20000725220833.N28657@strontium.scientia.demon.co.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: ; from sjmudd@pobox.com on Wed, Jul 26, 2000 at 07:34:29AM +0200 Organization: Sunesi Clinical Systems X-Operating-System: FreeBSD 3.3-RELEASE i386 X-URL: http://rucus.ru.ac.za/~nbm/ Sender: owner-freebsd-questions@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Wed 2000-07-26 (07:34), Simon J Mudd wrote: > > /usr/share/doc/handbook doesn't get updated, either by cvsup or a > > buildworld. > > Presumably this is true of some/all documentation supplied in FreeBSD? Only the stuff in the FreeBSD Documentation Project. This doesn't include the papers, usd, psd, and other bits there, but does include the handbook, the FAQ, the FreeBSD Documentation Project primer, and various articles. > > You need to cvsup doc-all (with tag=., NOT tag=RELENG_4), > > and do a 'make all install' in /usr/doc for that. > > I guess you mean > > 'make all install' in /usr/src/share/doc? No, he means in /usr/doc. /usr/doc is checked out when you cvsup doc-all (see /usr/share/examples/cvsup/doc-supfile). > Is there some reason that this is not specified/mentioned anywhere as > the handbook is a good attempt to give good documentation for FreeBSD and > any updates would be useful. > > I was specifically looking for: > - trying to see why the boot loader failed with a "BTX error" (from > memory), something fixed with 'make installkernel installworld' but > which didn't seem to work correctly just doing a make install from > /usr/src/sys/compile/. Read UPDATING, like you're supposed to. It explains that this is a problem. > The answers in 4.0's handbook are out of date/wrong. I was not sure who > to contact to get the right answer, or who to contact to update the > handbook with the right answers assuming I can find them. I _am_ a > relative newbie to FreeBSD, though I have used other versions of unix, > mainly linux for several years. By 4.0 we probably had the nice "If you have questions, ask questions@FreeBSD.org. If you have comments about this document, ask doc@FreeBSD.org" footer in place. If not, it'll appear soon. You can send doc fixes, just like ports and system fixes, using send-pr. You can also mail concerns to doc@FreeBSD.org, like it states at the top of the handbook front page. > The handbook and other documentation is good, but shouldn't the documentation > come with the system (?). They do come with the system when you install them. However, we can't expect everyone to install the tools necessary to build it, so they can either install them, or pick up updated copies from the location given at the top of the handbook's front page. It is in convenient package or tarball form, and in PDF, PostScript, RTF, HTML, and a few other formats. Neil -- Neil Blakey-Milner Sunesi Clinical Systems nbm@mithrandr.moria.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-questions" in the body of the message