From owner-freebsd-doc  Thu Nov  1  9:20: 9 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id B56CA37B403
	for <freebsd-doc@freebsd.org>; Thu,  1 Nov 2001 09:20:00 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id fA1HK0c27996;
	Thu, 1 Nov 2001 09:20:00 -0800 (PST)
	(envelope-from gnats)
Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18])
	by hub.freebsd.org (Postfix) with ESMTP id 5D87F37B401
	for <FreeBSD-gnats-submit@freebsd.org>; 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
X-Send-Pr-Version: 3.2
Subject: docs/31695: upgrade instructions for 3-stable to 4-stable
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         31695
>Category:       docs
>Synopsis:       upgrade instructions for 3-stable to 4-stable
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Nov 01 09:20:00 PST 2001
>Closed-Date:
>Last-Modified:
>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 ----
        </qandaentry>
  
        <qandaentry>
+         <question id="upgrade-3x-4x-source-failure">
+           <para>When I try to upgrade from 3.X to 4-STABLE, the
+             buildworld fails.  What can I do?</para>
+         </question>
+ 
+         <answer>
+           <para>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).</para>
+         </answer>
+       </qandaentry>
+ 
+       <qandaentry>
          <question id="boot-floppy-strangeness">
            <para>Strange things happen when I boot the install floppy!
              What is happening?</para>
>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message