From owner-doc-jp@jp.freebsd.org  Mon Oct 20 17:09:38 1997
Received: by jaz.jp.freebsd.org (8.8.7+2.7Wbeta7/8.7.3) id RAA02665
	Mon, 20 Oct 1997 17:09:38 +0900 (JST)
Received: by jaz.jp.freebsd.org (8.8.7+2.7Wbeta7/8.7.3) with ESMTP id RAA02660
	for <doc-jp@jp.freebsd.org>; Mon, 20 Oct 1997 17:09:32 +0900 (JST)
Received: from bourbon.sfc.wide.ad.jp (t6fuOjXp+3gStbkgpyb2/rpo9mR/Ygez@localhost [127.0.0.1]) by access.sfc.wide.ad.jp (8.8.7/3.5Wpl107/15/97) with ESMTP id RAA01390; Mon, 20 Oct 1997 17:09:30 +0900 (JST)
Message-Id: <199710200809.RAA01390@access.sfc.wide.ad.jp>
To: doc-jp@jp.freebsd.org
Cc: max@wide.ad.jp
From: Masafumi NAKANE/=?ISO-2022-JP?B?GyRCQ2Y6LDJtSjgbKEI=?= <max@wide.ad.jp>
X-Mailer: Mew version 1.70 on Emacs 19.28.1 / Mule 2.3
X-PGP-Fingerprint: 00 D8 2C CA C7 75 D4 40  5C 34 39 BA A5 46 C0 CC
Mime-Version: 1.0
Content-Type: Multipart/Mixed;
	boundary="--Next_Part(Mon_Oct_20_17:08:57_1997)--"
Content-Transfer-Encoding: 7bit
Date: Mon, 20 Oct 1997 17:09:29 +0900
Reply-To: doc-jp@jp.freebsd.org
Precedence: bulk
X-Distribute: distribute [version 2.1 (Alpha) patchlevel=20]
X-Sequence: doc-jp 3508
Subject: [doc-jp 3508] ctm.sgml updated
Errors-To: owner-doc-jp@jp.freebsd.org
Sender: owner-doc-jp@jp.freebsd.org

----Next_Part(Mon_Oct_20_17:08:57_1997)--
Content-Type: Text/Plain; charset=iso-2022-jp
Content-Transfer-Encoding: 7bit

$BCf:,$G$9!#(B

$B!!:FEY(B ctm.sgml $B$,99?7$5$l$^$7$?!#(B
$B!!$A$g$C$H:#B>$N$3$H$G<j0lGU$J$s$G$9$,$I$J$?$+Bg5^$.$G$d$C$F$$$?$@$1$k(B
$BJ}$O$$$i$C$7$c$i$J$$$G$7$g$&$+!)(B
$B!!0J2<$K(B diff $B$r$D$1$F$*$-$^$9$N$G!"$A$g$C$HD/$a$F$_$F!V$h$7$d$C$F$d$m(B
$B$&!W$H;W$C$?J}$,$$$i$7$?$i!"0l@<$"$2$F$+$i:n6H$K$H$j$+$+$C$F$$$?$@$1$l(B
$B$P$H;W$$$^$9!#(B

$B$=$l$G$O$h$m$7$/$*4j$$$7$^$9!#(B

$BCf:,2mJ8(B

----Next_Part(Mon_Oct_20_17:08:57_1997)--
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

Index: ctm.sgml
===================================================================
RCS file: /home/ncvs/doc/handbook/ctm.sgml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- ctm.sgml	1997/10/19 13:32:08	1.21
+++ ctm.sgml	1997/10/20 07:45:23	1.22
@@ -3,7 +3,7 @@
 #
 # Converted by Ollivier Robert <roberto@FreeBSD.ORG>
 #
-# $Id: ctm.sgml,v 1.21 1997/10/19 13:32:08 jraynard Exp $
+# $Id: ctm.sgml,v 1.22 1997/10/20 07:45:23 jkh Exp $
 #
 # ----------------------------------------------------------------------------
 # "THE BEER-WARE LICENSE" (Revision 42):
@@ -16,7 +16,7 @@
 
 <sect1><heading>CTM<label id="ctm"></heading>
 
-<p><em>Contributed by &a.phk;.  Updated 31-July-1997.</em>
+<p><em>Contributed by &a.phk;.  Updated 19-October-1997.</em>
 
         <tt/CTM/ is a method for keeping a remote directory tree in sync with a
         central one.  It has been developed for usage with FreeBSD's source
@@ -26,17 +26,24 @@
         for more information should you wish to use <tt/CTM/ for other things.
 
     <sect2><heading>Why should I use <tt/CTM/?</heading>
-      <p><tt/CTM/ will give you a local copy of the ``FreeBSD-current''
-        sources.  If you are an active developer on FreeBSD, but have lousy
-        or non-existent TCP/IP connectivity, <tt/CTM/ was made for you.
-        You will need to transfer up to four deltas per day (or you can
-        have them arrive in email automatically), the sizes for which are
+      <p><tt/CTM/ will give you a local copy of the FreeBSD source trees.
+	There are a number of ``flavors'' of the tree available. Whether
+	you wish to track the entire cvs tree or just one of the branches,
+	<tt/CTM/ can provide you the information.
+        If you are an active developer on FreeBSD, but have lousy
+        or non-existent TCP/IP connectivity,  or simply wish to have the
+	changes automatically sent to you, <tt/CTM/ was made for you.
+        You will need to obtain up to three deltas per day for the most 
+	active branches. However, you should consider having them sent
+	by automatic email. The sizes of the updates are
         always kept as small as possible.  This is typically less than 5K,
-        with the occasional (one in ten) being 10-50K and every now and
+        with an occasional (one in ten) being 10-50K and every now and
         then a biggie of 100K+ or more coming around.
 
-        You will also need to make yourself aware of the various caveats in
-        running ``current'' sources, and for this it is recommended that
+        You will also need to make yourself aware of the various caveats 
+	related to working directly from the development sources rather
+	than a pre-packaged release. This is particularly true if you
+	choose the ``current'' sources. It is recommended that
         you read <ref id="current" name="Staying current with FreeBSD">.
 
     <sect2><heading>What do I need to use <tt/CTM/?</heading>
@@ -65,11 +72,13 @@
         FTP the relevant directory and fetch the <tt/README/ file,
         starting from there.
 
-        If you only have access to electronic mail or are otherwise blocked
-        from using FTP then you may wish to get your deltas via email:
+        If you may wish to get your deltas via email:
 
-        Send email to &a.majordomo to subscribe to
-        the list ``ctm-src-cur''.  (If you do not know how to subscribe
+        Send email to &a.majordomo to subscribe to one of the  <tt/CTM/
+	distribution lists. ``ctm-cvs-cur'' supports the entire cvs tree.
+	``ctm-src-cur'' supports the head of the development branch.
+	``ctm-src-2_2'' supports the 2.2 release branch, etc.
+        (If you do not know how to subscribe
         yourself using majordomo, send a message first containing the
         word ``help'' - it will send you back usage instructions.)
 
@@ -89,20 +98,27 @@
 
     <sect2><heading>Starting off with <tt/CTM/ for the first time</heading>
       <p>Before you can start using <tt/CTM/ deltas, you will need to get a
-        special ``base'' delta that provides the starting point for all
-        deltas produced subsequently to it.
-
-        You can recognize a base delta by the ``<tt/Empty/'' appended to the
-        number (<tt/src-cur.0341Empty.gz/ for instance).  As a rule a base
-        delta is produced every 100 deltas, the next one will be
-        <tt/src-cur.0400Empty.gz/.  By the way, they are large!  50 to 100
-        Megabytes of <tt/gzip/'ed data is common for a base delta.
-
-<!--
-        If you do have the 2.0-RELEASE <tt/srcdist/, you can instead
-        retrieve the <tt/src-cur.0372R20.gz/ file, it is only 4Mb and it
-        will take you to level 372 from the 2.0-RELEASE sources.
--->
+         to a starting point for the deltas produced subsequently to it.
+  
+ 	First you should determine what you already have. Everyone can
+ 	start from an ``Empty'' directory. However, since the trees are
+ 	many tens of megabytes, you should prefer to start from something
+ 	already at hand. If you have a RELEASE CD, you can copy or extract
+ 	an initial source from it. This will save a significant transfer
+ 	of data.
+ 
+ 	Once you identify a suitable starting point, you must use an initial
+ 	``transition'' delta to transform your starting point into a
+ 	<tt/CTM/ supported tree.
+ 
+         You can recognize these transition  deltas by the ``<tt/X/'' appended
+ 	to the number (<tt/src-cur.3210XEmpty.gz/ for instance).
+ 	The designation following the ``<tt/X/'' corresponds to the origin
+ 	of your initial ``seed''. ``Empty'' is an empty directory, ``R225''
+ 	would designate the 2.2.5 release, etc.
+ 	As a rule a base transition from ``Empty'' is producted 
+        every 100 deltas.  By the way, they are large!  25 to 30
+        Megabytes of <tt/gzip/'ed data is common for the ``XEmpty'' deltas.
 
         Once you've picked a base delta to start from, you will also need
         all deltas with higher numbers following it.
@@ -112,7 +128,7 @@
         To apply the deltas, simply say:
         <tscreen><verb>
 cd /where/ever/you/want/the/stuff
-ctm -v -v /where/you/store/your/deltas/src-cur.*
+ctm -v -v /where/you/store/your/deltas/src-xxx.*
         </verb></tscreen>
       <p>
         <tt/CTM/ understands deltas which have been put through <tt/gzip/,
@@ -186,7 +202,7 @@
        run the commands:
       <tscreen><verb>
 cd /where/ever/you/want/to/extract/it/
-ctm -e '^lib/libc/Makefile' ~ctm/src-cur.*
+ctm -e '^lib/libc/Makefile' ~ctm/src-xxx.*
       </verb></tscreen>
       <p>
        For every file specified in a CTM delta, the ``<tt>-e</tt>'' and

----Next_Part(Mon_Oct_20_17:08:57_1997)----
