Date: Thu, 13 Feb 2014 14:53:15 +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: r43895 - head/en_US.ISO8859-1/books/handbook/mirrors Message-ID: <201402131453.s1DErFaR012541@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: dru Date: Thu Feb 13 14:53:15 2014 New Revision: 43895 URL: http://svnweb.freebsd.org/changeset/doc/43895 Log: Improve readability. Submitted by: bjk 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 Thu Feb 13 11:39:16 2014 (r43894) +++ head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml Thu Feb 13 14:53:15 2014 (r43895) @@ -133,10 +133,10 @@ 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> + repository or just a specified set of branches.</para> <para><application>CTM</application> is specifically designed for - use on lousy or non-existent TCP/IP connections. It provides + use on lousy or non-existent TCP/IP connections and 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 @@ -153,7 +153,7 @@ <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> + answers to questions on using <application>CTM</application>.</para> <sect2 xml:id="mirrors-ctm"> <title>Getting Deltas</title> @@ -165,8 +165,8 @@ <para><acronym>FTP</acronym> deltas can be obtained from the following mirror sites. When using anonymous <acronym>FTP</acronym> to obtain - <application>CTM</application> deltas, select a geographically - close mirror. In case of problems, contact the + <application>CTM</application> deltas, select a mirror that is + geographically nearby. In case of problems, contact the &a.ctm-users.name; mailing list.</para> <variablelist> @@ -228,7 +228,7 @@ of the <literal>ctm-src</literal> distribution lists available from <uri xlink:href="http://lists.freebsd.org/mailman/listinfo">http://lists.freebsd.org/mailman/listinfo</uri>. - For example, &a.ctm-src-cur.name; supports the HEAD of the + For example, &a.ctm-src-cur.name; supports the head development branch and &a.ctm-src-9.name; supports the 9.X release branch.</para> @@ -242,8 +242,8 @@ <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> + only mechanism by which <application>CTM</application> + announcements are posted.</para> </note> </sect2> @@ -275,18 +275,18 @@ <screen>&prompt.root; <userinput>cd /directory/to/store/the/stuff</userinput> &prompt.root; <userinput>ctm -v -v /directory/which/stores/the/deltas/src-xxx.*</userinput></screen> - <para>Multiple deltas can be applied at one time as they will + <para>Multiple deltas can be applied with a single command as they will be processed one at a time and any deltas that are already applied will be ignored. <application>CTM</application> - understands deltas which have been put through - <command>gzip</command>, which saves disk space.</para> + understands + <command>gzip</command> compressed deltas, which saves disk space.</para> <para>To verify a delta without applying it, include - <option>-c</option>. <application>CTM</application> will not - actually touch the local tree but will instead verify the + <option>-c</option> in the command line. <application>CTM</application> will not + actually modify the local tree but will instead verify the integrity of the delta to see if it would apply cleanly. Refer to &man.ctm.1; for more information about available - switches and an overview of the process + options and an overview of the process <application>CTM</application> uses when applying deltas.</para> @@ -295,8 +295,9 @@ <application>CTM</application>.</para> <para>Once applied, it is recommended to not delete the deltas - if it is a burden to download them again. This way, a loca - copy is available in case something bad happens.</para> + if it is a burden to download them again. This way, a local + copy is available in case it is needed for future disaster + recovery.</para> </sect2> <sect2> @@ -343,7 +344,7 @@ <listitem> <para>To backup all of the files that would be changed by a <application>CTM</application> update, specify - <option>-B backup-file</option>. This option tells + <option>-B <replaceable>backup-file</replaceable></option>. This option tells <application>CTM</application> to backup all files touched by the applied <application>CTM</application> delta to <filename>backup-file</filename>.</para>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201402131453.s1DErFaR012541>