Bug 31695

Summary: upgrade instructions for 3-stable to 4-stable
Product: Documentation Reporter: Michael W Lucas <mwlucas>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Michael W Lucas 2001-11-01 17:20:00 UTC 
The FAQ should include instructions on how to upgrade from 3-stable to
4-stable.

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.
How-To-Repeat: 
Read -stable.  See all the poor bastards who are trying to do this,
and failing.
Comment 1 Dima Dorfman 2001-11-04 22:33:39 UTC 
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.
Comment 2 Murray Stokely freebsd_committer freebsd_triage 2001-11-05 08:45:17 UTC 
State Changed
From-To: open->closed

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!