Many stylistic and grammar changes.

1 files changed, 91 insertions, 71 deletions

diff --git a/share/FAQ/ctm.FAQ b/share/FAQ/ctm.FAQ
index 75d8885..45d5929 100644
--- a/share/FAQ/ctm.FAQ
+++ b/share/FAQ/ctm.FAQ
@@ -1,3 +1,5 @@
+This is the ftp://freefall.cdrom.com/pub/CTM/README file:
+
 # ----------------------------------------------------------------------------
 # "THE BEER-WARE LICENSE" (Revision 42):
 # <phk@login.dknet.dk> wrote this file.  As long as you retain this notice you
@@ -5,97 +7,126 @@
 # this stuff is worth it, you can buy me a beer in return.   Poul-Henning Kamp
 # ----------------------------------------------------------------------------
 #
-# $Id$
+# Mon Feb 27 00:06:22 PST 1995
 #
 
 		Obtaining FreeBSD-current sources using CTM.
 		============================================
 
-CTM is a method to keep a remote directory-tree in sync with a central one.
-It has been developed for FreeBSD usage, but other people might use it as 
-time goes by, but little if any documentations exists on this time on the
-process of creating deltas.
+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
+trees, though other people may find it useful for other purposes as
+time goes by.  Little, if any, documentation currently exists at this
+time on the process of creating deltas so talk to phk@FreeBSD.org for
+more information should you wish to use CTM for other things.
 
 
 Why should I use CTM ?
 ----------------------
-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, CTM is made for you. 
-You will need to pick up up to four deltas per day (or you can have them 
-arrive in email automatically) and sizes are as small as we can do it:
-typically less than 5K, one delta in ten is like 10-50K and every now and
-then a biggie of 100K+ comes around.
+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, 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 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 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
+refer to the relevant FAQ: /usr/share/FAQ/current-policy.FAQ
+
+If you have commit priviledges or are similary authorized by the
+FreeBSD core team, you can also get access to the CVS repository tree
+by the same means.  Contact me (phk@FreeBSD.org) for details.
+
+
+NOTE:
+
+All the "DES infected" (e.g. export controlled) source is not included.
+You will get the "international" version only.  If sufficient interest
+appears, we will set up a "sec-cur" sequence too.
 
-You need to make yourself aware of the caveats of following the "current"
-sources, refer to the relevant FAQ for more info on that topic.
+There is a sequence of deltas for the ports collection too, but interest
+has not been all that high yet.  Tell me if you want an email list for
+that too and we'll consider setting it up.
 
+What do I need to use CTM?
+--------------------------
 
-What do I need to use CTM ?
----------------------------
-You need two things.  The "ctm" program and the stuff to feed it.  "ctm" is
-in the FreeBSD-current tree from version 2.0.0 and forward. (src/usr.sbin/ctm)
+You will need two things: The "ctm" program and the initial deltas to
+feed it (to get up to "current" levels).
 
-The "deltas" you feed ctm can be had two ways, ftp or email.
+The ctm program is in the FreeBSD-current tree from version 2.0.0 and
+forward (/usr/src/usr.sbin/ctm).  If you are running an older version
+of FreeBSD, you can fetch the current ctm sources directly from:
 
+	ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/src/usr.sbin/ctm/
 
-FTP-access:
------------
-The CTM-deltas can be found on the following sites:
+The "deltas" you feed ctm can be had two ways, ftp or email.  If you
+have general ftp access to the Internet, then the following ftp sites
+support access to CTM:
 
 	ftp://freefall.cdrom.com/pub/CTM
 
+Ftp the the relevant directory and fetch the README file, starting
+from there.
 
-eMail-access:
--------------
-Send email to majordomo@freebsd.org, subscribe to the list "ctm-src-cur".
-Use the ctm_rmail program to unpack and apply the emails with.  You can
-actually use the ctm_rmail program directly from a entry in /etc/aliases
-if you want.  Check the "ctm_rmail" man page.
+If you only have access to electronic mail or are otherwise blocked
+from using ftp, then you may wish to receive your deltas via email:
 
+Send email to majordomo@freebsd.org to subscribe to the list
+"ctm-src-cur" (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).
 
-How to get started.
--------------------
-You need to get up to speed.  You have two choices:
+When you begin receiving your CTM updates in the mail, you may use the
+ctm_rmail program to unpack and apply them with.  You can actually use
+the ctm_rmail program directly from a entry in /etc/aliases if you
+want.  Check the "ctm_rmail" man page for more details.
 
-Every now and then I will produce a special additional delta: a delta from
-nothing.  You can recognize these in two ways, the are large: 25 to 30
-Megabytes gzip'ed, and they have an 'A' appended to the number. 
-(src-cur.0341A.gz for instance).
 
-The other option is if you have the 2.0-RELEASE already, either from the
-internet or from the CDROM, you can pick up the src-cur.0372R20.gz file,
-which is a delta from the 2.0R.
+Starting off with CTM for the first time:
+-----------------------------------------
 
-In both cases will you need all deltas with higher numbers too.
+Before you can start using CTM deltas, you will need to get a special
+"base" delta that provides a starting point for all deltas produced
+subsequently to it.  You can recognize these in two ways: One is that
+they are large!  25 to 30 Megabytes of gzip'ed data being common for a
+base delta.  Second, they also have an 'A' appended to the number
+(src-cur.0341A.gz for instance).  Once you've picked a base delta to
+start from, you will also need all deltas with higher numbers
+following it.
+
+Using CTM in your daily life:
+-----------------------------
 
-Now working...
---------------
 To apply the deltas, simply say
 
 	cd /where/ever/you/want/the/stuff
 	ctm -v -v /where/you/store/your/deltas/src-cur.*
 
-Unless it feels very secure about the entire thing, ctm will not touch
-your tree.  To check out a delta you can add a "-c", then ctm will never
-touch you tree.
+Unless it feels very secure about the entire process, ctm will not
+touch your tree.  To check out a delta you can also use the "-c" flag
+and CTM won't actually touch your tree.
 
-There are other options to ctm as well, look in the sources.  It's a 
-little bit confusing right now, but it will become better I hope.
+There are other options to ctm as well, look in the sources.  It's a
+little bit confusing right now, but I promise to fix all of that very
+shortly.
 
-I would be very happy if somebody will help with the "user-interface"
-part, as I have realized that I can't make up my mind on what options
-should do what, how and when...
+I would also be very happy if somebody could help with the "user
+interface" portions, as I have realized that I can't make up my mind
+on what options should do what, how and when...
 
-ctm understands deltas which have been put through gzip, so you don't need
-to gunzip them first.
+CTM understands deltas which have been put through gzip, so you don't
+need to gunzip them first.
 
-That's really all there is to it.  Everytime you get a new delta, you 
+That's really all there is to it.  Everytime you get a new delta, you
 run it through ctm.
 
-Don't remove the deltas, if they are hard to download again.  You just might
-want to keep them around in case something bad happens.  Even if you only have
-floppy disks, consider using "fdwrite" to make a copy.
+Don't remove the deltas, if they are hard to download again.  You just
+might want to keep them around in case something bad happens.  Even if
+you only have floppy disks, consider using "fdwrite" to make a copy.
 
 
 Plans:
@@ -105,21 +136,11 @@ Tons of them.  Don't forget to tell me what you want though...
 
 Misc. stuff:
 ------------
-If you are a frequent or valuable contributor to FreeBSD, I will be willing
-to arrange special services, one option is delivery via ftp or rcp to a
-machine closer to you.  You need to have earned this, since it takes time
-to do, but I'll be all the more happy to do it for you then.
-
-Only if you have commit priviledge, or are similary authorized, can you get 
-access to the cvs tree by the same means.  Contact phk@FreeBSD.org for that.
-
-All the "DES-infected" source is not included.  You will get the
-"international" version only.  If sufficient interest appears, we will
-setup a "sec-cur" sequence too.
-
-There is a sequence of deltas for the "ports" too, but the interest has not
-been to big yet, tell me if you want an email list for that too.
-
+If you are a frequent or valuable contributor to FreeBSD, I will be
+willing to arrange special services, one option is delivery via ftp or
+rcp to a machine closer to you.  You need to have earned this, since
+it takes time to do, but I'll be all the more happy to do it for you
+then.
 
 Thanks!
 -------
@@ -129,7 +150,6 @@ Stephen McKay, wrote ctm_[rs]mail, much appreceiated.
 Jordan Hubbard, for being so stubborn that I had to make it better.
 All the users,  I hope you like it...
 
-
 Comments ?
 ----------
 email phk@FreeBSD.org