Date: Wed, 31 Oct 2001 12:00:02 -0800 (PST) From: Nils Holland <nils@tisys.org> To: freebsd-doc@freebsd.org Subject: Re: docs/31663: Small Inconsistency in "-Current vs. -Stable" Section Message-ID: <200110312000.f9VK02n67752@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/31663; it has been noted by GNATS. From: Nils Holland <nils@tisys.org> To: Chern Lee <chern@FreeBSD.org> Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/31663: Small Inconsistency in "-Current vs. -Stable" Section Date: Wed, 31 Oct 2001 20:58:16 +0100 (CET) Ok, I embedded the plain text diff below. I hope that will work, since it's the first time I submit something and wasn't really sure how to do it best ;-) Furthermore, I hope that there won't be problems attaching this diff as there have been (I think) two submissions for changes to the same chapter today. If there are problems with this, then I can wait until the other submissions have been added, then re-do my changes on the updated chapter and re-submit my diff. Greetings Nils *** chapter.sgml Wed Oct 24 00:12:31 2001 --- chapter-new Tue Oct 30 23:58:22 2001 *************** *** 228,234 **** <para>Use the <link linkend="cvsup">cvsup</link> program with <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/standard-supfile">this ! supfile</ulink>. This is the second most recommended method, since it allows you to grab the entire collection once and then only what has changed from then on. Many people run <command>cvsup</command> from --- 228,234 ---- <para>Use the <link linkend="cvsup">cvsup</link> program with <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/standard-supfile">this ! supfile</ulink>. This is the most recommended method, since it allows you to grab the entire collection once and then only what has changed from then on. Many people run <command>cvsup</command> from *************** *** 420,447 **** <orderedlist> <indexterm> ! <primary><command>CTM</command></primary> ! </indexterm> ! <indexterm> ! <primary>-STABLE</primary> ! <secondary>syncing with CTM</secondary> ! </indexterm> ! <listitem> ! <para>Use the <application><link ! linkend="ctm">CTM</link></application> facility. Unless ! you have a good TCP/IP connection at a flat rate, this ! is the way to do it.</para> ! </listitem> ! ! <indexterm> ! <primary>-STABLE</primary> <secondary>syncing with CVSup</secondary> </indexterm> <listitem> <para>Use the <link linkend="cvsup">cvsup</link> program with <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/stable-supfile">this ! supfile</ulink>. This is the second most recommended method, since it allows you to grab the entire collection once and then only what has changed from then on. Many people run <command>cvsup</command> from --- 420,433 ---- <orderedlist> <indexterm> ! <primary>-STABLE</primary> <secondary>syncing with CVSup</secondary> </indexterm> <listitem> <para>Use the <link linkend="cvsup">cvsup</link> program with <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/src/share/examples/cvsup/stable-supfile">this ! supfile</ulink>. This is the most recommended method, since it allows you to grab the entire collection once and then only what has changed from then on. Many people run <command>cvsup</command> from *************** *** 474,482 **** <screen><prompt>ftp></prompt> <userinput>cd usr.bin</userinput> <prompt>ftp></prompt> <userinput>get lex.tar</userinput></screen> </listitem> ! </orderedlist> ! </listitem> <listitem> <para>Essentially, if you need rapid on-demand access to the source and communications bandwidth is not a consideration, --- 460,481 ---- <screen><prompt>ftp></prompt> <userinput>cd usr.bin</userinput> <prompt>ftp></prompt> <userinput>get lex.tar</userinput></screen> </listitem> ! ! <indexterm> ! <primary>-STABLE</primary> ! <secondary>syncing with CTM</secondary> ! </indexterm> ! <listitem> ! <para>Use the <application><link ! linkend="ctm">CTM</link></application> facility. If you don't have ! a fast and inexpensive connection to the Internet, this is the method ! you should consider using. ! </para> ! </listitem> ! </orderedlist> ! </listitem> + <indexterm> <listitem> <para>Essentially, if you need rapid on-demand access to the source and communications bandwidth is not a consideration, On Wed, 31 Oct 2001, Chern Lee wrote: > I agree, everyone uses CVSup nowadays. > > Do you think you could attach the diff as plaintext? Gnats doesn't seem > to want to recognize your attachment and pass it on. > > Thanks. > > - chern > > On Wed, 31 Oct 2001, Nils Holland wrote: > > > > > >Number: 31663 > > >Category: docs > > >Synopsis: Small Inconsistency in "-Current vs. -Stable" Section > > >Confidential: no > > >Severity: non-critical > > >Priority: low > > >Responsible: freebsd-doc > > >State: open > > >Quarter: > > >Keywords: > > >Date-Required: > > >Class: change-request > > >Submitter-Id: current-users > > >Arrival-Date: Wed Oct 31 07:20:01 PST 2001 > > >Closed-Date: > > >Last-Modified: > > >Originator: Nils Holland > > >Release: FreeBSD 4.4-STABLE i386 > > >Organization: > > Ti Systems > > >Environment: > > System: FreeBSD howie.ncptiddische.net 4.4-STABLE FreeBSD 4.4-STABLE #0: Sat Oct 27 13:59:06 CEST 2001 root@jodie.ncptiddische.net:/usr/obj/usr/src/sys/HOWIE i386 > > > > >Description: > > When I routinely read some stuff in the handbook today, I noticed > > a small inconsistency in the "-Current vs. -Stable" part of the > > "Cutting Edge" section of the handbook: In the part that deals with > > -Current, CVSup is recommended as the best source sync method, > > while CTM is said to be problematic. In the part that deals with > > -Stable, however, CTM is listed as the most preferred method, and > > no problems resulting from its used are mentioned. > > I have now changed it so that CVSup is listed as the best method > > in both sections (most people are using it anway). Furthermore, > > I listed CTM as third most recommended way, saying that it is > > probably well suited for people with a slower connection. > > This fixes the small inconsistency, so that the parts telling > > how to stay current with -Current and how to stay current > > with -Stable contain the same (accurate) information and no > > contradictions anymore. > > > > >How-To-Repeat: > > Read the current -Current vs. -Stable section in the handbook > > and you will see what I mean... > > > > >Fix: > > The following diff, to be applied to > > books/handbook/cutting-edge/chapter.sgml makes the whole thing > > a little more sane, as you will hopefully be able to see. > > > > begin 644 chapter.tar.gz > > M'XL(",,1X#L"`V-H87!T97(N=&%R`.U6;6_;-A#V5^=77/UA`S++>K$:!YXJ > > M8.TZ(,"*%8B[?J9%VB(FD0))U?&_WY&28GDS6@Q#AR7E`T,TCV_'N^>.5Y2D > > M,4PM*-_M)E\)<13=I"E,`.+5RZAO8]LZK-(XQN]R%45Q=+-,<1C'EQ.()O\! > > M6FV(`I@(7NG/SV-*3YX=KJ^OH>@YH/=U-?W(*/Q6&$A2B*)UG*R7,23HF:L@ > > M"(:9@6"'Z:9E;N(R@F2Y?GF[3I)NXO4Y;!^2Y':>H&N=`&`ZS1JB2/Y!,S`E > > M@ZSBX@^P'R;HJUGQ2;?-+'=-%EIQ#HV2>T5JMQC@P$T)66N'>DFKJE>SG6G6 > > M88C?Q2^*L=?W/R^DVH=-NPW[_M`&1:L4$R;4J@AU210+V0.IFXKIT!T;(BT$ > > M)8H&V-GQBLUR4W)]]<(=ULNRT&F0+P`V.`CXL[?1K)""0BVU`87_ZQIOQ6BO > > M:,U,*>D<-!<%`VZ`5)4\:("C;,%(P%MNW3:H'E>L7U7(JF*%X5*`M.M0.3O) > > M]JHC'$IBH"3:.DCLT8,[)6LWWB^7`G5\1\01&B;QEJ!:`9E5#3<:##UTN]7. > > MX8/?\'_P[/WVU!UV*?#2))JGZ6H(/+N[S;F95)0I1BNN33X(4<SQW@\8X76. > > M%CLA:Q2OB3KFCQJ\V;P[G9^%P_AH51:>;7;QA.G?#@CN-S^]_O7MV8[(NBZD > > M;%\?1<'%OF.2T^(T-CKF\N'VNMRPNM_UG,ND:2I>$.NRW!&[)\V)WJ:>=1=W > > M[,G"\0K8D8)7W!S1;Q\$\G'@G&5)23XA`V`O)87-F_?AW7ODAQ`]/Y`*!'85 > > M-HH8-H<187MF'LC1,HU*I-\";6/U'E]V?*]_8VOXG*U_O[><&UD;+EH;+EC[ > > MJ62.;<6^[7SOTL5R.>3[?Y0NIIY>7X5>S_)96J7S]#89U8.Z0$-BXD6WU(W) > > MT>3?[<V/ECRNC[[!`IR+IC5Y0:'5:K'E`BWV*+URU/OBXCTS4+&'!5;]X]7( > > MO$Z!,>W.GHM.=!8(3CJ>-D3,.3>[J+#T?*NU]09ZZC@'OG.N$@SMK$C#*5HW > > MH,R:#DA1X`MBW8C&/ZFD9:MZIUDCMZ)_?31L47;@%$F,K!'2OB@82)JCMF[& > > MO`OO&PSOVWA4SCT)LP-T[_6W4#O<=:R@4GQO7-W0[X05`L$\8%W/!7MH&#H7 > > MBXI1&=&1!>X$:BZ8Z>J(QR3BLL6H)-&E;"OZ2!)T+5IFT4_X0HDQO1P*?XF$ > > J'RX]$__;\)AX>'AX>'AX>'AX>'AX>'AX>'AX>'AX/!_\"8<+'J\`*``` > > ` > > end > > > > >Release-Note: > > >Audit-Trail: > > >Unformatted: > > SEND-PR: -*- send-pr -*- > > SEND-PR: Lines starting with `SEND-PR' will be removed automatically, as > > SEND-PR: will all comments (text enclosed in `<' and `>'). > > SEND-PR: > > SEND-PR: Please consult the send-pr man page `send-pr(1)' or the Texinfo > > SEND-PR: manual if you are not sure how to fill out a problem report. > > SEND-PR: Note that the Synopsis field is mandatory. > > SEND-PR: > > SEND-PR: Choose from the following categories: > > SEND-PR: > > SEND-PR: advocacy alpha bin conf docs gnu > > SEND-PR: i386 kern misc ports sparc > > SEND-PR: > > To: FreeBSD-gnats-submit@freebsd.org > > From: Nils Holland <nils@tisys.org> > > Reply-To: Nils Holland <nils@tisys.org> > > Cc: > > X-send-pr-version: 3.113 > > X-GNATS-Notify: > > > > > > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > > with "unsubscribe freebsd-doc" in the body of the message > > > > > > Nils Holland Ti Systems - FreeBSD in Tiddische, Germany http://www.tisys.org * nils@tisys.org 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?200110312000.f9VK02n67752>