Date: Thu, 22 Mar 2001 11:11:17 -0500 (EST) From: Robert Watson <rwatson@FreeBSD.org> To: doc@FreeBSD.org Cc: jkh@FreeBSD.org Subject: makeworld documentation in handbook confuses users Message-ID: <Pine.NEB.3.96L.1010322110530.10372F-100000@fledge.watson.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.NEB.3.96L.1010322110530.10372F-100000>