From owner-freebsd-doc  Sun Nov  4 14:40: 5 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 A172A37B405
	for <freebsd-doc@freebsd.org>; Sun,  4 Nov 2001 14:40:02 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id fA4Me2a40342;
	Sun, 4 Nov 2001 14:40:02 -0800 (PST)
	(envelope-from gnats)
Date: Sun, 4 Nov 2001 14:40:02 -0800 (PST)
Message-Id: <200111042240.fA4Me2a40342@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Dima Dorfman <dima@trit.org>
Subject: Re: docs/31695: upgrade instructions for 3-stable to 4-stable 
Reply-To: Dima Dorfman <dima@trit.org>
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

The following reply was made to PR docs/31695; it has been noted by GNATS.

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.

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