From mwlucas@blackhelicopters.org  Thu Nov  1 09:16:06 2001
Return-Path: <mwlucas@blackhelicopters.org>
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
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 ----
        </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:

From: Dima Dorfman <dima@trit.org>
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 ----
 >         </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>
 
 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 <maketarget>.
 
 > +         </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
           should be underscore, not dash --> ^^^^
 
 > +             4.1.1-RELEASE (RELENG_4_1_1_RELEASE).  Finally, upgrade to
 > +             4-STABLE (RELENG_4).</para>
 
 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.  <literal> and
 <symbol> 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 <literal>
 or <symbol> 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:
