Date: Sun, 1 Apr 2001 22:21:35 -0400 (EDT) From: Robert Watson <rwatson@FreeBSD.org> To: doc@FreeBSD.org Cc: jkh@FreeBSD.org Subject: Re: makeworld documentation in handbook confuses users Message-ID: <Pine.NEB.3.96L.1010401222051.77053D-100000@fledge.watson.org> In-Reply-To: <Pine.NEB.3.96L.1010322110530.10372F-100000@fledge.watson.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Was wondering if any progress was made on this front. Would be nice to get it fixed before 4.3-RELEASE. I saw some text fly back and forth but no commits... Also, Jordan, any luck with checking cvsupit for accuracy in cvsup-file creation / etc? Robert N M Watson FreeBSD Core Team, TrustedBSD Project robert@fledge.watson.org NAI Labs, Safeport Network Services On Thu, 22 Mar 2001, Robert Watson wrote: > > In the name of improving testing of 4.3-BETA, I had a co-worker of mine > install a 4.2-RELEASE box yesterday, then update to -STABLE. He found the > makeworld instructions in the handbook very confusing, and potentially > inconsistent. For example, he was left unclear at the end over whether > the kernel or the world should be installed first, as the first part of > the document clearly states kernel first, and the second part slips back > into world first. Is there any chance we could get this text simplified a > bit before 4.3-RELEASE goes out the door? In particular, it would be > useful to add the following to the document, if it's not explicitly there > already: > > /* > * 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. 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. > */ > > # cd /usr/src > # make installworld > # mergemaster # optional merging of /etc > # shutdown -r NOW # or pick your poison > > Robert N M Watson FreeBSD Core Team, TrustedBSD Project > robert@fledge.watson.org NAI Labs, Safeport Network Services > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-doc" in the body of the message > To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.NEB.3.96L.1010401222051.77053D-100000>