From owner-svn-doc-head@FreeBSD.ORG Wed Feb 12 19:08:16 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 9B76B13B; Wed, 12 Feb 2014 19:08:16 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 854CD130E; Wed, 12 Feb 2014 19:08:16 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s1CJ8G72037207; Wed, 12 Feb 2014 19:08:16 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s1CJ8Ged037206; Wed, 12 Feb 2014 19:08:16 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201402121908.s1CJ8Ged037206@svn.freebsd.org> From: Dru Lavigne Date: Wed, 12 Feb 2014 19:08:16 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43885 - head/en_US.ISO8859-1/books/handbook/mirrors X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 12 Feb 2014 19:08:16 -0000 Author: dru Date: Wed Feb 12 19:08:16 2014 New Revision: 43885 URL: http://svnweb.freebsd.org/changeset/doc/43885 Log: First pass at improving the flow of this chapter. More commits to come. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml Wed Feb 12 16:48:56 2014 (r43884) +++ head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml Wed Feb 12 19:08:16 2014 (r43885) @@ -84,26 +84,26 @@ - FTP Sites + <acronym>FTP</acronym> Sites The official sources for &os; are available via anonymous - FTP from a worldwide set of mirror sites. The site + FTP from a worldwide set of mirror sites. The site ftp://ftp.FreeBSD.org/pub/FreeBSD/ is well connected and allows a large number of connections to it, but you are probably better off finding a closer mirror site (especially if you decide to set up some sort of mirror site). - Additionally, &os; is available via anonymous FTP from the + Additionally, &os; is available via anonymous FTP from the following mirror sites. If you choose to obtain &os; via - anonymous FTP, please try to use a site near you. The mirror + anonymous FTP, please try to use a site near you. The mirror sites listed as Primary Mirror Sites typically have the entire &os; archive (all the currently available versions for each of the architectures) but you will probably have faster download times from a site that is in your country or region. The regional sites carry the most recent versions for the most popular architecture(s) but might not carry the - entire &os; archive. All sites provide access via anonymous FTP + entire &os; archive. All sites provide access via anonymous FTP but some sites also provide access via other methods. The access methods available for each site are provided in parentheses after the hostname. @@ -138,99 +138,117 @@ CTM is a method for keeping a - remote directory tree in sync with a central one. It has been - developed for usage with &os;'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 contact the - &a.ctm-users.name; mailing list for more information and if you - wish to use CTM for other - things. + remote directory tree in sync with a central one. It is built into &os; + and can be used to synchronize a system with &os;'s source repositories. + It supports synchronization of an entire repository or just the specified branches. + + CTM is specifically designed for use on + lousy or non-existent TCP/IP connections. It provides the ability + for changes to be automatically sent by email. It requires the user + to obtain up to three deltas per day for the most active + branches. Update sizes are always kept as + small as possible and are typically less than 5K. About one in very ten + update is 10-50K in size and rarely there will be an update + larger than 100K+. - - Why Should I Use <application>CTM</application>? + When using CTM to track &os; development, + refer to the + caveats related to working directly from the development + sources rather than a pre-packaged release. These are discussed + in Tracking a Development Branch. - CTM will give you a local copy - of the &os; 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, - CTM can provide you the - information. If you are an active developer on &os;, but have - lousy or non-existent TCP/IP connectivity, or simply wish to - have the changes automatically sent to you, - 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 an - occasional (one in ten) being 10-50K and every now and then a - large 100K+ or more coming around. + Little documentation exists on + the process of creating deltas or using CTM + for other purposes. Contact the + &a.ctm-users.name; mailing list for questions on using + CTM. - 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 Staying current with &os;. - + + Getting Deltas - - What Do I Need to Use - <application>CTM</application>? + The deltas used by + CTM can be obtained either through + anonymous FTP or + email. + + FTP deltas can be obtained from the following mirror sites. + Download the relevant directory and read its + README. When using anonymous FTP to obtain CTM deltas, + select a geographically close mirror. + In case of problems, contact the &a.ctm-users.name; + mailing list. - You will need two things: The - CTM program, and the initial deltas - to feed it (to get up to current - levels). + + + California, Bay Area, official source + + + + + ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/ + + + ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/ + + + + - The CTM program has been part - of &os; ever since version 2.0 was released, and lives in - /usr/src/usr.sbin/ctm if you have a copy - of the source available. + + South Africa, backup server for old deltas - 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://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/ + + + + - ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/ + + Taiwan/R.O.C. - or see section mirrors. + + + + ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/ + - FTP the relevant directory and fetch the - README file, starting from there. + + ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/ + - If you wish to get your deltas via email: + + ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/ + + + + + - Subscribe to one of the + To instead receive deltas through email, subscribe to one of the CTM distribution lists. - &a.ctm-src-cur.name; supports the entire Subversion tree. - &a.ctm-src-cur.name; supports the head of the development - branch. &a.ctm-src-9.name; supports the 9.X release branch, - etc.. (If you do not know how to subscribe yourself to a - list, click on the list name above or go to - &a.mailman.lists.link; and click on the list that you wish to - subscribe to. The list page should contain all of the - necessary subscription instructions.) - - When you begin receiving your - CTM updates in the mail, you may - use the ctm_rmail program to unpack and - apply them. You can actually use the - ctm_rmail program directly from a entry in - /etc/aliases if you want to have the - process run in a fully automated fashion. Check the - ctm_rmail manual page for more + &a.ctm-src-cur.name; supports the entire source tree, + &a.ctm-src-cur.name; supports the HEAD of the development + branch, and &a.ctm-src-9.name; supports the 9.X release branch. + + As + CTM updates arrive through email, + use ctm_rmail to unpack and + apply them. This command can be run directly from an entry in + /etc/aliases in order to + automate this process. Refer to + &man.ctm.rmail.1; for more details. - No matter what method you use to get the - CTM deltas, you should subscribe - to the &a.ctm-announce.name; mailing list. In the future, - this will be the only place where announcements concerning - the operations of the CTM system - will be posted. Click on the list name above and follow the - instructions to subscribe to the list. + Regardless of the method which is used to get deltas, + CTM users should subscribe + to the &a.ctm-announce.name; mailing list as + this is the only place where announcements concerning + the operation of the CTM system + are posted. @@ -238,18 +256,11 @@ Using <application>CTM</application> for the First Time - Before you can start using CTM - deltas, you will need to get 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. - You must use an initial Empty delta to start - off your CTM supported tree. At - some point it is intended that one of these - started deltas be distributed on the CD for - your convenience, however, this does not currently - happen. + Before CTM + deltas can be used, a starting point for the + deltas must be produced from an empty directory. + An initial Empty delta is used to start + the local CTM-supported tree. Since the trees are many tens of megabytes, you should prefer to start from something already at hand. If you have a @@ -409,76 +420,11 @@ counter intuitive. - - - - Miscellaneous Stuff There is a sequence of deltas for the ports collection too, but interest has not been all that high yet. - - - CTM Mirrors - - CTM/&os; is available via - anonymous FTP from the following mirror sites. If you choose - to obtain CTM via anonymous FTP, - please try to use a site near you. - - In case of problems, please contact the &a.ctm-users.name; - mailing list. - - - - California, Bay Area, official source - - - - - ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/ - - - - - - - South Africa, backup server for old deltas - - - - - ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/ - - - - - - - Taiwan/R.O.C. - - - - - ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/ - - - - ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/ - - - - ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/ - - - - - - - If you did not find a mirror near to you or the mirror is - incomplete, try to use a search engine such as alltheweb. - @@ -2507,7 +2453,7 @@ usr.bin/ which transfers only the differences between two sets of files, thus greatly speeding up the synchronization over the network. This is most useful if you are a mirror site for the - &os; FTP server, or the CVS repository. The + &os; FTP server, or the CVS repository. The rsync suite is available for many operating systems, on &os;, see the net/rsync @@ -2523,12 +2469,12 @@ usr.bin/ Available collections: - ftp: A partial mirror of the &os; FTP + ftp: A partial mirror of the &os; FTP server. - &os;: A full mirror of the &os; FTP server. + &os;: A full mirror of the &os; FTP server. @@ -2543,7 +2489,7 @@ usr.bin/ Available collections: - &os;: A full mirror of the &os; FTP server. + &os;: A full mirror of the &os; FTP server. @@ -2559,7 +2505,7 @@ usr.bin/ - &os;: A full mirror of the &os; FTP server. + &os;: A full mirror of the &os; FTP server. @@ -2569,7 +2515,7 @@ usr.bin/ &os;-Archive: The mirror of &os; Archive - FTP server. + FTP server. @@ -2584,7 +2530,7 @@ usr.bin/ Available collections: - &os;: A full mirror of the &os; FTP server. + &os;: A full mirror of the &os; FTP server. @@ -2603,7 +2549,7 @@ usr.bin/ Available collections: - &os;: A full mirror of the &os; FTP server. + &os;: A full mirror of the &os; FTP server. @@ -2619,7 +2565,7 @@ usr.bin/ ftp.freebsd.org: A full mirror of the &os; - FTP server. + FTP server. @@ -2636,7 +2582,7 @@ usr.bin/ Available collections: - &os;: The master archive of the &os; FTP + &os;: The master archive of the &os; FTP server. @@ -2651,7 +2597,7 @@ usr.bin/ - &os;: A full mirror of the &os; FTP server. + &os;: A full mirror of the &os; FTP server.