From owner-freebsd-doc Sun Apr 1 19:21:40 2001 Delivered-To: freebsd-doc@freebsd.org Received: from fledge.watson.org (fledge.watson.org [204.156.12.50]) by hub.freebsd.org (Postfix) with ESMTP id 0C59D37B71B; Sun, 1 Apr 2001 19:21:37 -0700 (PDT) (envelope-from robert@fledge.watson.org) Received: from fledge.watson.org (robert@fledge.pr.watson.org [192.0.2.3]) by fledge.watson.org (8.11.1/8.11.1) with SMTP id f322LZh81984; Sun, 1 Apr 2001 22:21:36 -0400 (EDT) (envelope-from robert@fledge.watson.org) Date: Sun, 1 Apr 2001 22:21:35 -0400 (EDT) From: Robert Watson X-Sender: robert@fledge.watson.org To: doc@FreeBSD.org Cc: jkh@FreeBSD.org Subject: Re: makeworld documentation in handbook confuses users In-Reply-To: Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org 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