Date: Wed, 12 Feb 2014 19:08:16 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> 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 Message-ID: <201402121908.s1CJ8Ged037206@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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 @@ </sect1> <sect1 xml:id="mirrors-ftp"> - <title>FTP Sites</title> + <title><acronym>FTP</acronym> Sites</title> <para>The official sources for &os; are available via anonymous - FTP from a worldwide set of mirror sites. The site + <acronym>FTP</acronym> from a worldwide set of mirror sites. The site <uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/">ftp://ftp.FreeBSD.org/pub/FreeBSD/</uri>; is well connected and allows a large number of connections to it, but you are probably better off finding a <quote>closer</quote> mirror site (especially if you decide to set up some sort of mirror site).</para> - <para>Additionally, &os; is available via anonymous FTP from the + <para>Additionally, &os; is available via anonymous <acronym>FTP</acronym> 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 <acronym>FTP</acronym>, please try to use a site near you. The mirror sites listed as <quote>Primary Mirror Sites</quote> 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 <acronym>FTP</acronym> but some sites also provide access via other methods. The access methods available for each site are provided in parentheses after the hostname.</para> @@ -138,99 +138,117 @@ </indexterm> <para><application>CTM</application> 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 <application>CTM</application> for other - things.</para> + 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.</para> + + <para><application>CTM</application> 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+.</para> - <sect2> - <title>Why Should I Use <application>CTM</application>?</title> + <para>When using <application>CTM</application> 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 <link linkend="current-stable">Tracking a Development Branch</link>.</para> - <para><application>CTM</application> will give you a local copy - of the &os; source trees. There are a number of - <quote>flavors</quote> of the tree available. Whether you - wish to track the entire CVS tree or just one of the branches, - <application>CTM</application> 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, - <application>CTM</application> 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.</para> + <para>Little documentation exists on + the process of creating deltas or using <application>CTM</application> + for other purposes. Contact the + &a.ctm-users.name; mailing list for questions on using + <application>CTM</application>.</para> - <para>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 <quote>current</quote> - sources. It is recommended that you read <link linkend="current">Staying current with &os;</link>.</para> - </sect2> + <sect2 xml:id="mirrors-ctm"> + <title>Getting Deltas</title> - <sect2> - <title>What Do I Need to Use - <application>CTM</application>?</title> + <para>The <quote>deltas</quote> used by + <application>CTM</application> can be obtained either through + anonymous <acronym>FTP</acronym> or + email.</para> + + <para><acronym>FTP</acronym> deltas can be obtained from the following mirror sites. + Download the relevant directory and read its + <filename>README</filename>. When using anonymous <acronym>FTP</acronym> to obtain <application>CTM</application> deltas, + select a geographically close mirror. + In case of problems, contact the &a.ctm-users.name; + mailing list.</para> - <para>You will need two things: The - <application>CTM</application> program, and the initial deltas - to feed it (to get up to <quote>current</quote> - levels).</para> + <variablelist> + <varlistentry> + <term>California, Bay Area, official source</term> + + <listitem> + <itemizedlist> + <listitem> + <para><uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>; + </listitem> + <listitem> + <para><uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/</uri></para>; + </listitem> + </itemizedlist> + </listitem> + </varlistentry> - <para>The <application>CTM</application> program has been part - of &os; ever since version 2.0 was released, and lives in - <filename>/usr/src/usr.sbin/ctm</filename> if you have a copy - of the source available.</para> + <varlistentry> + <term>South Africa, backup server for old deltas</term> - <para>The <quote>deltas</quote> you feed - <application>CTM</application> 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 - <application>CTM</application>:</para> + <listitem> + <itemizedlist> + <listitem> + <para><uri xlink:href="ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/</uri></para>; + </listitem> + </itemizedlist> + </listitem> + </varlistentry> - <para><uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/</uri></para>; + <varlistentry> + <term>Taiwan/R.O.C.</term> - <para>or see section <link linkend="mirrors-ctm">mirrors</link>.</para> + <listitem> + <itemizedlist> + <listitem> + <para><uri xlink:href="ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>; + </listitem> - <para>FTP the relevant directory and fetch the - <filename>README</filename> file, starting from there.</para> + <listitem> + <para><uri xlink:href="ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>; + </listitem> - <para>If you wish to get your deltas via email:</para> + <listitem> + <para><uri xlink:href="ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>; + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> - <para>Subscribe to one of the + <para>To instead receive deltas through email, subscribe to one of the <application>CTM</application> 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.)</para> - - <para>When you begin receiving your - <application>CTM</application> updates in the mail, you may - use the <command>ctm_rmail</command> program to unpack and - apply them. You can actually use the - <command>ctm_rmail</command> program directly from a entry in - <filename>/etc/aliases</filename> if you want to have the - process run in a fully automated fashion. Check the - <command>ctm_rmail</command> 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.</para> + + <para>As + <application>CTM</application> updates arrive through email, + use <command>ctm_rmail</command> to unpack and + apply them. This command can be run directly from an entry in + <filename>/etc/aliases</filename> in order to + automate this process. Refer to + &man.ctm.rmail.1; for more details.</para> <note> - <para>No matter what method you use to get the - <application>CTM</application> 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 <application>CTM</application> system - will be posted. Click on the list name above and follow the - instructions to subscribe to the list.</para> + <para>Regardless of the method which is used to get deltas, + <application>CTM</application> users should subscribe + to the &a.ctm-announce.name; mailing list as + this is the only place where announcements concerning + the operation of the <application>CTM</application> system + are posted.</para> </note> </sect2> @@ -238,18 +256,11 @@ <title>Using <application>CTM</application> for the First Time</title> - <para>Before you can start using <application>CTM</application> - deltas, you will need to get to a starting point for the - deltas produced subsequently to it.</para> - - <para>First you should determine what you already have. - Everyone can start from an <quote>empty</quote> directory. - You must use an initial <quote>Empty</quote> delta to start - off your <application>CTM</application> supported tree. At - some point it is intended that one of these - <quote>started</quote> deltas be distributed on the CD for - your convenience, however, this does not currently - happen.</para> + <para>Before <application>CTM</application> + deltas can be used, a starting point for the + deltas must be produced from an <quote>empty</quote> directory. + An initial <quote>Empty</quote> delta is used to start + the local <application>CTM</application>-supported tree.</para> <para>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.</para> </listitem> </itemizedlist> - </sect2> - - <sect2> - <title>Miscellaneous Stuff</title> <para>There is a sequence of deltas for the <literal>ports</literal> collection too, but interest has not been all that high yet.</para> </sect2> - - <sect2 xml:id="mirrors-ctm"> - <title>CTM Mirrors</title> - - <para><link linkend="ctm">CTM</link>/&os; is available via - anonymous FTP from the following mirror sites. If you choose - to obtain <application>CTM</application> via anonymous FTP, - please try to use a site near you.</para> - - <para>In case of problems, please contact the &a.ctm-users.name; - mailing list.</para> - - <variablelist> - <varlistentry> - <term>California, Bay Area, official source</term> - - <listitem> - <itemizedlist> - <listitem> - <para><uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>; - </listitem> - </itemizedlist> - </listitem> - </varlistentry> - - <varlistentry> - <term>South Africa, backup server for old deltas</term> - - <listitem> - <itemizedlist> - <listitem> - <para><uri xlink:href="ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/</uri></para>; - </listitem> - </itemizedlist> - </listitem> - </varlistentry> - - <varlistentry> - <term>Taiwan/R.O.C.</term> - - <listitem> - <itemizedlist> - <listitem> - <para><uri xlink:href="ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>; - </listitem> - - <listitem> - <para><uri xlink:href="ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>; - </listitem> - - <listitem> - <para><uri xlink:href="ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>; - </listitem> - </itemizedlist> - </listitem> - </varlistentry> - </variablelist> - - <para>If you did not find a mirror near to you or the mirror is - incomplete, try to use a search engine such as <link xlink:href="http://www.alltheweb.com/">alltheweb</link>.</para>; - </sect2> </sect1> <sect1 xml:id="svn"> @@ -2507,7 +2453,7 @@ usr.bin/</programlisting> 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; <acronym>FTP</acronym> server, or the CVS repository. The <application>rsync</application> suite is available for many operating systems, on &os;, see the <package>net/rsync</package> @@ -2523,12 +2469,12 @@ usr.bin/</programlisting> <para>Available collections:</para> <itemizedlist> <listitem> - <para>ftp: A partial mirror of the &os; FTP + <para>ftp: A partial mirror of the &os; <acronym>FTP</acronym> server.</para> </listitem> <listitem> - <para>&os;: A full mirror of the &os; FTP server.</para> + <para>&os;: A full mirror of the &os; <acronym>FTP</acronym> server.</para> </listitem> </itemizedlist> </listitem> @@ -2543,7 +2489,7 @@ usr.bin/</programlisting> <para>Available collections:</para> <itemizedlist> <listitem> - <para>&os;: A full mirror of the &os; FTP server.</para> + <para>&os;: A full mirror of the &os; <acronym>FTP</acronym> server.</para> </listitem> </itemizedlist> </listitem> @@ -2559,7 +2505,7 @@ usr.bin/</programlisting> <itemizedlist> <listitem> - <para>&os;: A full mirror of the &os; FTP server.</para> + <para>&os;: A full mirror of the &os; <acronym>FTP</acronym> server.</para> </listitem> <listitem> @@ -2569,7 +2515,7 @@ usr.bin/</programlisting> <listitem> <para>&os;-Archive: The mirror of &os; Archive - FTP server.</para> + <acronym>FTP</acronym> server.</para> </listitem> </itemizedlist> </listitem> @@ -2584,7 +2530,7 @@ usr.bin/</programlisting> <para>Available collections:</para> <itemizedlist> <listitem> - <para>&os;: A full mirror of the &os; FTP server.</para> + <para>&os;: A full mirror of the &os; <acronym>FTP</acronym> server.</para> </listitem> </itemizedlist> </listitem> @@ -2603,7 +2549,7 @@ usr.bin/</programlisting> <para>Available collections:</para> <itemizedlist> <listitem> - <para>&os;: A full mirror of the &os; FTP server.</para> + <para>&os;: A full mirror of the &os; <acronym>FTP</acronym> server.</para> </listitem> </itemizedlist> </listitem> @@ -2619,7 +2565,7 @@ usr.bin/</programlisting> <itemizedlist> <listitem> <para>ftp.freebsd.org: A full mirror of the &os; - FTP server.</para> + <acronym>FTP</acronym> server.</para> </listitem> </itemizedlist> </listitem> @@ -2636,7 +2582,7 @@ usr.bin/</programlisting> <para>Available collections:</para> <itemizedlist> <listitem> - <para>&os;: The master archive of the &os; FTP + <para>&os;: The master archive of the &os; <acronym>FTP</acronym> server.</para> </listitem> @@ -2651,7 +2597,7 @@ usr.bin/</programlisting> <itemizedlist> <listitem> - <para>&os;: A full mirror of the &os; FTP server.</para> + <para>&os;: A full mirror of the &os; <acronym>FTP</acronym> server.</para> </listitem> </itemizedlist> </listitem>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201402121908.s1CJ8Ged037206>