From owner-freebsd-doc Mon Nov 27 19:57:28 2000 Delivered-To: freebsd-doc@freebsd.org Received: from 2711.dynacom.net (2711.dynacom.net [206.107.213.3]) by hub.freebsd.org (Postfix) with ESMTP id 8945637B4FE; Mon, 27 Nov 2000 19:57:22 -0800 (PST) Received: from urx.com (dsl1-160.dynacom.net [206.159.132.160]) by 2711.dynacom.net (Build 101 8.9.3/NT-8.9.3) with ESMTP id TAA00913; Mon, 27 Nov 2000 19:57:20 -0800 Message-ID: <3A232D20.606BD20E@urx.com> Date: Mon, 27 Nov 2000 19:57:20 -0800 From: Kent Stewart Reply-To: kstewart@urx.com Organization: Dynacom X-Mailer: Mozilla 4.76 [en] (Windows NT 5.0; U) X-Accept-Language: en MIME-Version: 1.0 To: Garance A Drosihn Cc: current@FreeBSD.ORG, freebsd-doc@FreeBSD.ORG Subject: Re: status of http://www.freebsd.org/handbook/makeworld.html References: <3A231ADA.600ACF42@urx.com> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Garance A Drosihn wrote: > > At 6:39 PM -0800 11/27/00, Kent Stewart wrote: > >Garance A Drosihn wrote: > >> > >> Unless I'm missing something, which is certainly possible, it > >> seems to me that > >> http://www.freebsd.org/handbook/makeworld.html > >> > >> is missing some information that it used to have. There is no > >> section on mergemaster, for instance, even though there IS a > >> link to that section, and that link thinks the section is on > >> the same web page. > >> > >> I get a vague feeling that something else on the page isn't > >> right, but I can't think of what that might be. Probably > >> the section on building kernels, because it does not actually > >> mention the 'buildkernel' or 'installkernel' targets. > > > >I thought the following instructions were quite explicit and > >they were > > > >18.4.1. Read /usr/src/UPDATING > > > >Before you do anything else, read /usr/src/UPDATING [...]. > >If UPDATING contradicts something you read here, UPDATING > >takes precedence. > > I would think that somewhere along the line we would update > the information in the handbook, just out of courtesy. If > we have no intention of ever updating this web page, then > let's remove the 'makeworld.html' web page, and replace it > with a pointer to the UPDATING file. Which UPDATING file are you going to point to. It can be different for each release of the system. The manual way also still applies for the older versions. > > That disclaimer also does not explain why the web page itself > THINKS that it has a section on mergemaster, but it has no > such section. I think you mis-interpreted that sentence because they recommend that you use Mergemaster and if you do use mergemaster, you bypass the manual update section and proceed to the section. which is on updating /dev. Mergemaster isn't the next section. > > I have enough saved messages and useful pointers (including > UPDATING) that I have already updated my system quite fine, > and do not need any explicit instructions on where to go. I > am just saying this web page in the handbook could be more > helpful. What's more, I could have sworn that at one time > the web page DID have a section on mergemaster... > > [but that's the part that I might be imagining...] This section has been re-written a couple of times. I don't remember it ever mentioning mergemaster. I also couldn't argue one way or the other. Mergemaster, at one point in time, was a port and it is now part of the system and has its own man page. Kent > -- > Garance Alistair Drosehn = gad@eclipse.acs.rpi.edu > Senior Systems Programmer or gad@freebsd.org > Rensselaer Polytechnic Institute or drosih@rpi.edu > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-doc" in the body of the message -- Kent Stewart Richland, WA mailto:kbstew99@hotmail.com http://kstewart.urx.com/kstewart/index.html FreeBSD News http://daily.daemonnews.org/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message