Date: Wed, 26 Jul 2000 11:18:55 +0200 From: Neil Blakey-Milner <nbm@mithrandr.moria.org> To: Simon J Mudd <sjmudd@pobox.com> Cc: freebsd-questions@freebsd.org, Ben Smithurst <ben@FreeBSD.org> Subject: Re: /usr/share/doc/handbook/* updated with cvs? Message-ID: <20000726111855.A29061@mithrandr.moria.org> In-Reply-To: <lwu2ddpi8q.fsf@phoenix.ea4els.ampr.org>; from sjmudd@pobox.com on Wed, Jul 26, 2000 at 07:34:29AM %2B0200 References: <Pine.LNX.4.21.0007251808070.9309-100000@phoenix.ea4els.ampr.org> <20000725220833.N28657@strontium.scientia.demon.co.uk> <lwu2ddpi8q.fsf@phoenix.ea4els.ampr.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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/<mykernel>. 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000726111855.A29061>