From owner-freebsd-doc  Fri Nov  8  4:12:22 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 9D4AF37B401
	for <freebsd-doc@freebsd.org>; Fri,  8 Nov 2002 04:12:18 -0800 (PST)
Received: from lakemtao03.cox.net (lakemtao03.cox.net [68.1.17.242])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0262143E6E
	for <freebsd-doc@freebsd.org>; Fri,  8 Nov 2002 04:12:18 -0800 (PST)
	(envelope-from ataraxia@cox.net)
Received: from arkadia.nv.cox.net ([68.98.181.29]) by lakemtao03.cox.net
          (InterMail vM.5.01.04.05 201-253-122-122-105-20011231) with ESMTP
          id <20021108121211.PUKA16428.lakemtao03.cox.net@arkadia.nv.cox.net>
          for <freebsd-doc@freebsd.org>; Fri, 8 Nov 2002 07:12:11 -0500
Received: from arkadia.nv.cox.net (localhost [127.0.0.1])
	by arkadia.nv.cox.net (8.12.6/8.12.6) with ESMTP id gA8CCADd074544
	for <freebsd-doc@freebsd.org>; Fri, 8 Nov 2002 07:12:11 -0500 (EST)
	(envelope-from ataraxia@arkadia.nv.cox.net)
Received: (from ataraxia@localhost)
	by arkadia.nv.cox.net (8.12.6/8.12.6/Submit) id gA8CCAje074543
	for freebsd-doc@freebsd.org; Fri, 8 Nov 2002 07:12:10 -0500 (EST)
	(envelope-from ataraxia)
Date: Fri, 8 Nov 2002 07:12:10 -0500 (EST)
From: Ray Kohler <ataraxia@cox.net>
Message-Id: <200211081212.gA8CCAje074543@arkadia.nv.cox.net>
To: freebsd-doc@freebsd.org
Subject: upgrading doc for contribution
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


I've written a small, informal guide to upgrading from -stable
to -current that I thought might be useful to others. It's
meant to supplement the usual docs. I have no time to maintain
it, but I thought I'd see if anyone wanted to adopt it. I have
no intention to hold copyright on it.

- @

begin 644 upgrade.html
M/&AT;6P^"CQH96%D/@H\=&ET;&4^57!G<F%D:6YG($9R;VT@1G)E94)31"`T
M+E@@=&\@-2Y8/"]T:71L93X*/"]H96%D/@H\8F]D>3X*/&@Q/E5P9W)A9&EN
M9R!&<F]M($9R965"4T0@-"Y8('1O(#4N6#PO:#$^"CQP/E1H:7,@:7,@86X@
M:6YF;W)M86P@9W5I9&4@=&\@=7!G<F%D:6YG($9R965"4T0N($ET(&ES(&YO
M="!G=6%R86YT965D('1O('=O<FL@9F]R('EO=2P@8G5T(&ET(&ES("AA<'!R
M;WAI;6%T96QY*2!W:&%T('=O<FME9"!F;W(@;64N(%=H96X@=&AI<R!G=6ED
M92!C;VYF;&EC=',@=VET:"!A;GD@;V9F:6-I86P@9&]C=6UE;G0L('1H92!O
M9F9I8VEA;"!D;V-U;65N="!T86ME<R!P<F5C961E;F-E+CPO<#X*/&]L/@H\
M;&D^4F5A9"!T:&4@/&$@:')E9CTB:'1T<#HO+W=W=RYF<F5E8G-D+F]R9R]C
M9VDO8W9S=V5B+F-G:2]S<F,O55!$051)3D<B/E501$%424Y'/"]A/B!D;V-U
M;65N="P@=&\@;&]O:R!F;W(@86YY(&=O=&-H87,@;W(@<W1R86YG92!I<W-U
M97,@<W!E8VEF:6,@=&\@>6]U<B!S971U<"X@5&AE(&EM<&]R=&%N8V4@;V8@
M=&AI<R!S=&5P(&-A;FYO="!B92!S=')E<W-E9"!E;F]U9V@N("A&;VQL;W<@
M=&AE(&QI;FL@86YD('1H96X@9F]L;&]W('1H92!L:6YK(&]F('1H92!H:6=H
M97-T(&YU;6)E<F5D('9E<G-I;VXN*2!!;'-O(')E860@=&AE(#QA(&AR968]
M(FAT='`Z+R]W=W<N9G)E96)S9"YO<F<O9&]C+V5N7U53+DE33S@X-3DM,2]B
M;V]K<R]H86YD8F]O:R]C=71T:6YG+65D9V4N:'1M;"(^:&%N9&)O;VL@<V5C
M=&EO;B!O;B!S>7-T96T@=7!G<F%D:6YG/"]A/B!I9B!Y;W4G<F4@=6YF86UI
M;&EA<B!W:71H(&ET+CPO;&D^"CQL:3Y$;R!A(&9U;&P@8F%C:W5P(&]F('EO
M=7(@<WES=&5M+"!U<VEN9R!W:&%T979E<B!M971H;V0@>6]U('!R969E<BX@
M*$D@;&EK92!A9FEO+BD@268@<V]M971H:6YG(&=O97,@=W)O;F<@*&]R('EO
M=2!J=7-T(&1O;B=T(&QI:V4@=&AE(&YE=R!S>7-T96TI('EO=2=L;"!B92!G
M;&%D('EO=2!H879E(&ET+CPO;&D^"CQL:3Y296YA;64@>6]U<B`\<W1R;VYG
M/G-R8RUA;&P\+W-T<F]N9SX@8VAE8VMO=71S(&9I;&4Z/&)R/@H\;F]B<CX\
M='0^;78@+W5S<B]L;V-A;"]E=&,O8W9S=7`O<W5P+W-R8RUA;&PO8VAE8VMO
M=71S+G-R8RUA;&PZ4D5,14Y'7S0@+W5S<B]L;V-A;"]E=&,O8W9S=7`O<W5P
M+W-R8RUA;&PO8VAE8VMO=71S+G-R8RUA;&PZ+CPO='0^/"]N;V)R/CQB<CX*
M5&AI<R!I<R!T;R!H96QP(&-V<W5P('5P9&%T92!Y;W5R('-O=7)C97,@86-C
M=7)A=&5L>2P@86YD(&ES(&YO="!S=')I8W1L>2!N96-E<W-A<GDN("A)9B!Y
M;W4@<B!C:&5C:V]U=',@9FEL92!I<R!E;'-E=VAE<F4L('5S92!T:&%T(&QO
M8V%T:6]N(&EN<W1E860N*3PO;&D^"CQL:3Y#:&%N9V4@=&AE('1A9R!O9B`\
M<W1R;VYG/G-R8RUA;&P\+W-T<F]N9SX@9G)O;2`\<W1R;VYG/E)%3$5.1U\T
M/"]S=')O;F<^('1O(#QS=')O;F<^+CPO<W1R;VYG/B!I;B!Y;W5R(#QS=')O
M;F<^8W9S=7`\+W-T<F]N9SX@8V]N9FEG(&9I;&4N("A4:&%T)W,@82!L:71E
M<F%L('!E<FEO9"P@;F]T('!U;F-T=6%T:6]N+BD\+VQI/@H\;&D^4G5N(#QS
M=')O;F<^8W9S=7`\+W-T<F]N9SX@87,@;F]R;6%L+B!.;W<@>6]U('=I;&P@
M:&%V92`U+E@@<V]U<F-E<RX\+VQI/@H\;&D^5W)I=&4@82!N97<@:V5R;F5L
M(&-O;F9I9R!F:6QE(&9O<B`U+E@Z/&)R/@H\='0^8V0@+W-Y<R]I,S@V+V-O
M;F8\8G(^"FUV(%E/55)?0T].1DE'(%E/55)?0T].1DE'+C0\8G(^"F-P($=%
M3D5224,@64]54E]#3TY&24<\8G(^"B9L=#ME9&ET('1H92!F:6QE)F=T.SQB
M<CX\+W1T/@I)9B!Y;W4@=V5R92!U<VEN9R!T:&4@/'-T<F]N9SYD<FTM:VUO
M9#PO<W1R;VYG/B!P;W)T+"!Y;W4G;&P@=V%N="!T;R!R96UO=F4@:70@*&ET
M(&1O97-N)W0@=V]R:R!O;B`U+E@I(&%N9"!C;VUP:6QE('1H92!A<'!R;W!R
M:6%T92!D<FEV97(@:6YT;R!Y;W5R(&ME<FYE;"!I;G-T96%D+B`H4V5E(#QS
M=')O;F<^3D]415,\+W-T<F]N9SX@9F]R(&UO<F4@9&5T86EL<RX\+VQI/@H\
M;&D^;6%K92!S;VUE('-M86QL(&-H86YG97,@=&\@/'-T<F]N9SYM86ME+F-O
M;F8\+W-T<F]N9SXN(%EO=2=L;"!N965D('1O(&-H86YG92!A;GD@/'1T/D-0
M55194$4]9F]O/"]T=#X@;&EN97,@=&\@/'1T/D-055194$4_/69O;SPO='0^
M+B!!;'-O('EO=2!S:&]U;&0@861D(#QT=#Y#3TU0050T6#UT<G5E/"]T=#X@
M=&\@=&AI<R!F:6QE+CPO;&D^"CQL:3Y);G-T86QL('1H92`\<W1R;VYG/F1E
M=FEC92YH:6YT<SPO<W1R;VYG/B!F:6QE.CQB<CX*/'1T/F-P("]S>7,O:3,X
M-B]C;VYF+T=%3D5224,N:&EN=',@+V)O;W0O9&5V:6-E+FAI;G1S/"]T=#X\
M+VQI/@H\;&D^0G5I;&0@82!N97<@=V]R;&0@86YD(&ME<FYE;#H\8G(^"CQT
M=#YC9"`O=7-R+W-R8SQB<CX*;6%K92!B=6EL9'=O<FQD(&)U:6QD:V5R;F5L
M/"]T=#X\+VQI/@H\;&D^26YS=&%L;"!T:&4@;F5W(&ME<FYE;#H\8G(^"CQT
M=#YM86ME(&EN<W1A;&QK97)N96P\+W1T/CPO;&D^"CQL:3Y);G-T86QL(&$@
M;F5W(&)O;W1L;V%D97(@86YD(&)O;W1B;&]C:W,Z/&)R/@H\='0^8V0@+W-Y
M<R]B;V]T/&)R/@IM86ME(&EN<W1A;&P\+W1T/CPO;&D^"CQL:3Y296)O;W0@
M:6YT;R!S:6YG;&4M=7-E<B!M;V1E('=I=&@@>6]U<B!N97<@:V5R;F5L.CQB
M<CX*/'1T/G)E8F]O=#PO='0^/&)R/@I7:&5N('1H92!S>7-T96T@8F5G:6YS
M('1O(&)O;W0@86YD('EO=2!S964@=&AE(&-O=6YT9&]W;BP@<')E<W,@82!K
M97D@*&]T:&5R('1H86X@16YT97(I(&%N9"!T>7!E.CQB<CX*/'1T/F)O;W0@
M+7,\+W1T/CQB<CX*4')E<W,@16YT97(@870@=&AE(&YE>'0@<')O;7!T+"!T
M:&5N(&1O.CQB<CX*/'1T/FUO=6YT("UA/&)R/@IS=V%P;VX@+6$\8G(^"F%D
M:FME<FYT>B`M:3PO='0^/"]L:3X*/&QI/E)U;B`\='0^;65R9V5M87-T97(@
M+7`\+W1T/BX@5&AI<R!W:6QL(&)O;6(@870@=&AE(#QS=')O;F<^;6%K92YC
M;VYF/"]S=')O;F<^(&-O;7!A<FES;VX@<W1E<"P@8G5T('EO=2!C86X@:6=N
M;W)E('1H870N/"]L:3X*/&QI/DUO=F4@>6]U<B!O;&0@/'-T<F]N9SXO=7-R
M+VEN8VQU9&4\+W-T<F]N9SX@86YD(#QS=')O;F<^+W5S<B]S:&%R93PO<W1R
M;VYG/B!D:7)E8W1O<FEE<R!O=70@;V8@=&AE('=A>3H\8G(^"CQT=#YC9"`O
M=7-R/&)R/@IM=B!I;F-L=61E(&EN8VQU9&4N;VQD/&)R/@IM=B!S:&%R92!S
M:&%R92YO;&0\8G(^/"]T=#X*66]U)VQL('=A;G0@=&\@9&5L971E('1H97-E
M(&QA=&5R('=H96X@>6]U(&MN;W<@979E<GET:&EN9R=S($]++CPO;&D^"CQL
M:3Y);G-T86QL(#QS=')O;F<^;6%K93PO<W1R;VYG/B=S(&1A=&$@9FEL97,@
M<V\@/'1T/FUA:V4@:6YS=&%L;'=O<FQD/"]T=#X@8V%N(')U;CH\8G(^"CQT
M=#YM:V1I<B`M<"`O=7-R+W-H87)E+VUK/&)R/@IC<"`O=7-R+W-R8R]S:&%R
M92]M:R\J("]U<W(O<VAA<F4O;6L\+W1T/CPO;&D^"CQL:3Y);G-T86QL('1H
M92!N97<@=V]R;&0Z/&)R/@H\='0^;6%K92!I;G-T86QL=V]R;&0\+W1T/CPO
M;&D^"CQL:3Y2=6X@/'1T/FUE<F=E;6%S=&5R/"]T=#X@=&\@=7!D871E('EO
M=7(@8V]N9FEG(&9I;&5S(&EN(#QS=')O;F<^+V5T8SPO<W1R;VYG/BX@5&AE
M<F4@=VEL;"!B92!M86YY(&-H86YG97,@86YD(&$@=&AO<F]U9V@@:VYO=VQE
M9&=E(&]F(&AO=R!T;R!U<V4@/'-T<F]N9SYM97)G96UA<W1E<CPO<W1R;VYG
M/B!W;W5L9"!B92!M;W-T('5S969U;"X\+VQI/@H\;&D^0G)I;F<@=&AE('-Y
M<W1E;2!U<"!M=71I;'5S97(Z/&)R/@H\='0^97AI=#PO='0^/&)R/@I4:&4@
M<WES=&5M('=I;&P@9FEN:7-H(&)O;W1I;F<@86YD('EO=2!S:&]U;&0@;&]G
M(&EN=&\@:70N/"]L:3X*/&QI/D-L96%N('5P('1H92!C<G5F="!L969T(&]V
M97(@9G)O;2`T+E@N(%1H:7,@:7,@=&AE(&UO<W0@8V]M<&QI8V%T960@<W1E
M<"P@86QT:&]U9V@@:&%V:6YG(&$@9G)E<V@@/'-T<F]N9SXO=7-R+VEN8VQU
M9&4\+W-T<F]N9SX@86YD(#QS=')O;F<^+W5S<B]S:&%R93PO<W1R;VYG/B!M
M86ME<R!I="!E87-I97(N($)A<VEC86QL>2P@>6]U('=I;&P@=V%N="!T;R!L
M;V]K(&EN(&5A8V@@9&ER96-T;W)Y('=H97)E(&)A<V4@<WES=&5M(&9I;&5S
M(&%R92!I;G-T86QL960@9F]R(&]N97,@;VQD97(@=&AA;B!T:&4@8G5I;&0@
M=VAI8V@@>6]U(&1O;B=T(&AA=F4@82!R96%S;VX@=&\@:V5E<"X@/'1T/F9I
M;F0@+R`M;71I;64@*S$\+W1T/B!W:6QL('-H;W<@>6]U(&%L;"!T:&4@9FEL
M97,@>6]U(&AA=F4@=&AA="!H879E;B=T(&)E96X@;6]D:69I960@9F]R(&]V
M97(@82!D87DL(&%N9"!I<R!P<F]B86)L>2!A(&=O;V0@<&QA8V4@=&\@<W1A
M<G0[(&)U="!Y;W4@=VEL;"!S=&EL;"!H879E('1O(&UA:V4@:G5D:6-I;W5S
M('5S92!O9B!H86YD(&%N9"!E>65B86QL('1O(&1E=&5R;6EN92!T:&4@9FEL
M97,@>6]U(&]U9VAT('1O(&1E;&5T92X@*$YO=&4@=&AA="!Y;W4@8V%N('-A
M9F5L>2!S:VEP('1H:7,@<W1E<"!I9B!Y;W4@<F5A;&QY('=A;G0@=&\N*3PO
M;&D^"CQL:3Y);G-T86QL('1H92`\<W1R;VYG/G!E<FPU/"]S=')O;F<^('!O
M<G0Z/&)R/@H\='0^8V0@+W5S<B]P;W)T<R]L86YG+W!E<FPU/&)R/@IM86ME
M(&EN<W1A;&P@8VQE86X\+W1T/CQB<CX*268@>6]U(&%R92!S=7)E('EO=2!H
M879E(#QE;3YN;SPO96T^('!O<G1S('1H870@=7-E('!E<FPL('EO=2!C86X@
M<VMI<"!T:&ES('-T97`L(&)U="!T:&%T(&ES(&AI9VAL>2!U;FQI:V5L>2`H
M979E;B!8('5S97,@:70I+CPO;&D^"CQL:3Y296EN<W1A;&P@86QL('EO=7(@
M<&]R=',N($%T(&QE87-T('-O;64@;V8@=&AE;2!W:6QL(&9A:6P@=&\@=V]R
M:R!I9B!Y;W4@9&]N)W0L(&%N9"!Y;W4@=VEL;"!G970@82!P97)F;W)M86YC
M92!I;F-R96%S92!F<F]M('5S:6YG($=#0R`S+C(N($D@:&EG:&QY(')E8V]M
M;65N9"!T:&4@/'-T<F]N9SYP;W)T=7!G<F%D93PO<W1R;VYG/B!P;W)T(&9O
M<B!T:&ES+B!$;SH\8G(^"CQT=#YP;W)T=7!G<F%D92`M868\+W1T/CQB<CX*
M1&]N)W0@9F]R9V5T('1H870@86YY('!O<G1S('1H870@:&%V92!I;G1E<F%C
M=&EV92!B=6EL9"!P<F]C97-S97,@=VEL;"!H;VQD('5P('1H92!B=6EL9"!I
M9B!Y;W4G<F4@;F]T('1H97)E('1O(&%N<W=E<B!T:&5I<B!Q=65S=&EO;G,N
M/"]L:3X*/&QI/D1O(&%N;W1H97(@9G5L;"!B86-K=7`N($YO=R!T:&%T('EO
M=2!H879E(&$@;FEC92!C;&5A;B`U+E@@<WES=&5M+"!T:&ES(&ES(&$@9W)E
M870@=&EM92!T;R!P<F5S97)V92!I="!F;W(@<&]S=&5R:71Y("AO<B!A="!L
M96%S="!U;G1I;"!Y;W4@9V]O9B!I="!U<"!N97AT*2X\+VQI/@H\+V]L/@H\
.+V)O9'D^/"]H=&UL/@H`
`
end


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