From owner-freebsd-doc Thu Mar 22 8:30: 6 2001 Delivered-To: freebsd-doc@freebsd.org Received: from sol.cc.u-szeged.hu (sol.cc.u-szeged.hu [160.114.8.24]) by hub.freebsd.org (Postfix) with ESMTP id 0779337B71F for ; Thu, 22 Mar 2001 08:29:58 -0800 (PST) (envelope-from sziszi@petra.hos.u-szeged.hu) Received: from petra.hos.u-szeged.hu by sol.cc.u-szeged.hu (8.9.3+Sun/SMI-SVR4) id RAA10896; Thu, 22 Mar 2001 17:29:56 +0100 (MET) Received: from sziszi by petra.hos.u-szeged.hu with local (Exim 3.12 #1 (Debian)) id 14g7yG-0000ut-00 for ; Thu, 22 Mar 2001 17:29:56 +0100 Date: Thu, 22 Mar 2001 17:29:56 +0100 From: Szilveszter Adam To: doc@FreeBSD.org Subject: Re: makeworld documentation in handbook confuses users Message-ID: <20010322172956.A2469@petra.hos.u-szeged.hu> Mail-Followup-To: Szilveszter Adam , doc@FreeBSD.org References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: ; from rwatson@FreeBSD.org on Thu, Mar 22, 2001 at 11:11:17AM -0500 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi! I totally agree with the suggestion that this part of the Handbook needs more attention. So much so that I am looking at how I could come up with something reasonable. IMHO the Handbook should only document the "official" procedure as found on -STABLE or the latest -RELEASE. So largely what you wrote stands, two nits: On Thu, Mar 22, 2001 at 11:11:17AM -0500, Robert Watson wrote: > /* > * Build the new world, read the UPDATING notes first to see if there are > * any special actions of divergences from the normal procedure that must > * be taken to update. I think that UPDATING should be read first. Not often, but sometimes even building may require a kludge. More importantly, it should be emphasized that you should update your sources *first* and read it only *after*. Yes, there were questions around this:-) > Change GENERIC below to reflect your kernel of > * choice. > */ > > # cd /usr/src > # more UPDATING # make sure to read notes > # make buildworld > # make buildkernel KERNCONF=GENERIC # customize for your kernel > > /* > * Install your kernel first, reboot so it is running and new syscalls are > * suported. > */ > > # make installkernel KERNCONF=GENERIC # customize for your kernel > # shutdown -r NOW # or pick your poison > > /* > * Now install the world (userland, that is), optionally merge your > * etc tree (experts only), and then go ahead and reboot to bring up the > * new version of userland. I think that the /etc upgrade should take place in any case, since ignoring it may lead to your system becoming disfunctional. With mergemaster(8), it is easier. -- Regards: Szilveszter ADAM Szeged University Szeged Hungary To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message