Date: Sun, 4 Nov 2001 14:40:02 -0800 (PST) From: Dima Dorfman <dima@trit.org> To: freebsd-doc@freebsd.org Subject: Re: docs/31695: upgrade instructions for 3-stable to 4-stable Message-ID: <200111042240.fA4Me2a40342@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200111042240.fA4Me2a40342>