From mwlucas@blackhelicopters.org Thu Nov 1 09:16:06 2001 Return-Path: Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18]) by hub.freebsd.org (Postfix) with ESMTP id 5D87F37B401 for ; Thu, 1 Nov 2001 09:16:05 -0800 (PST) Received: (from mwlucas@localhost) by blackhelicopters.org (8.9.3/8.9.3) id MAA73914; Thu, 1 Nov 2001 12:15:56 -0500 (EST) (envelope-from mwlucas) Message-Id: <200111011715.MAA73914@blackhelicopters.org> Date: Thu, 1 Nov 2001 12:15:56 -0500 (EST) From: mwlucas@blackhelicopters.org Reply-To: mwlucas@blackhelicopters.org To: FreeBSD-gnats-submit@freebsd.org Subject: upgrade instructions for 3-stable to 4-stable X-Send-Pr-Version: 3.2 >Number: 31695 >Category: docs >Synopsis: upgrade instructions for 3-stable to 4-stable >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: closed >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Thu Nov 01 09:20:00 PST 2001 >Closed-Date: Mon Nov 5 00:45:17 PST 2001 >Last-Modified: Mon Nov 05 00:46:25 PST 2001 >Originator: Michael Lucas >Release: FreeBSD 3.5-STABLE i386 >Organization: None >Environment: -doc tree supped this morning >Description: The FAQ should include instructions on how to upgrade from 3-stable to 4-stable. >How-To-Repeat: Read -stable. See all the poor bastards who are trying to do this, and failing. >Fix: The following patch puts the upgrade info right in the install section of the FAQ, right after the bad144 3x-4x info. If the markup is wrong, please let me know as I'm trying to do this correctly. *** book.sgml-dist Thu Nov 1 12:00:01 2001 --- book.sgml Thu Nov 1 12:09:35 2001 *************** *** 1498,1503 **** --- 1498,1519 ---- + + When I try to upgrade from 3.X to 4-STABLE, the + buildworld fails. What can I do? + + + + Because of the many changes between 3.X and 4-STABLE, + a direct upgrade from source will probably fail. A source + upgrade can be done, but only in stages. First, upgrade + to the latest 3-STABLE (RELENG-3). Then upgrade to + 4.1.1-RELEASE (RELENG_4_1_1_RELEASE). Finally, upgrade to + 4-STABLE (RELENG_4). + + + + Strange things happen when I boot the install floppy! What is happening? >Release-Note: >Audit-Trail: From: Dima Dorfman To: mwlucas@blackhelicopters.org Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/31695: upgrade instructions for 3-stable to 4-stable Date: Sun, 04 Nov 2001 22:33:39 +0000 mwlucas@blackhelicopters.org wrote: > >Description: > > The FAQ should include instructions on how to upgrade from 3-stable to > 4-stable. Yes! This is long overdue. Thanks for writing this up. > *** 1498,1503 **** > --- 1498,1519 ---- > > > > + > + When I try to upgrade from 3.X to 4-STABLE, the > + buildworld fails. What can I do? Hmm, people don't seem to use "the buildworld". Perhaps just "buildworld" or "the buildworld target" would be better? Regardless, buildworld should be marked up in . > + > + > + > + Because of the many changes between 3.X and 4-STABLE, > + a direct upgrade from source will probably fail. A source > + upgrade can be done, but only in stages. First, upgrade > + to the latest 3-STABLE (RELENG-3). Then upgrade to should be underscore, not dash --> ^^^^ > + 4.1.1-RELEASE (RELENG_4_1_1_RELEASE). Finally, upgrade to > + 4-STABLE (RELENG_4). The doc tree seems to be split up about even on whether to mark up CVS tags (RELENG_3, RELENG_4, etc.) or just let them be. and both seem to be popular tags to mark them up in, but since there's ample precedent for just leaving them alone, it's probably up to you. Personally, I'd mark them up, but I'm not sure if or is better. Thanks. State-Changed-From-To: open->closed State-Changed-By: murray State-Changed-When: Mon Nov 5 00:45:17 PST 2001 State-Changed-Why: A FAQ entry already exists for upgrading from 3.x to 4.x that just discourages the user from trying a source update. I've updated this entry rather than adding a contradictory new entry. I also applied Dima's suggestions. Thanks for the submission! http://www.FreeBSD.org/cgi/query-pr.cgi?pr=31695 >Unformatted: