White space fix only. Translators can ignore.

Sponsored by: iXsystems
This commit is contained in:
Dru Lavigne 2014-02-12 21:31:34 +00:00
parent 29da518808
commit 9145ff93b5
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=43888

View file

@ -28,7 +28,8 @@
Phone: <phone>+1 925 240-6652</phone> Phone: <phone>+1 925 240-6652</phone>
Fax: <fax>+1 925 674-0821</fax> Fax: <fax>+1 925 674-0821</fax>
Email: <email>info@freebsdmall.com</email> Email: <email>info@freebsdmall.com</email>
WWW: <otheraddr xlink:href="http://www.freebsdmall.com/">http://www.freebsdmall.com/</otheraddr> WWW: <otheraddr
xlink:href="http://www.freebsdmall.com/">http://www.freebsdmall.com/</otheraddr>
</address> </address>
</listitem> </listitem>
@ -39,7 +40,8 @@
<postcode>D-81371</postcode> <city>M&uuml;nchen</city> <postcode>D-81371</postcode> <city>M&uuml;nchen</city>
<country>Germany</country> <country>Germany</country>
Phone: <phone>(0177) 428 419 0</phone> Phone: <phone>(0177) 428 419 0</phone>
WWW: <otheraddr xlink:href="http://www.hinner.de/linux/freebsd.html">http://www.hinner.de/linux/freebsd.html</otheraddr> WWW: <otheraddr
xlink:href="http://www.hinner.de/linux/freebsd.html">http://www.hinner.de/linux/freebsd.html</otheraddr>
</address> </address>
</listitem> </listitem>
@ -50,7 +52,8 @@
<city>Margate</city> <city>Margate</city>
<postcode>CT9 2TB</postcode> <postcode>CT9 2TB</postcode>
<country>United Kingdom</country> <country>United Kingdom</country>
WWW: <otheraddr xlink:href="https://linux-distro.co.uk/">https://linux-distro.co.uk/</otheraddr> WWW: <otheraddr
xlink:href="https://linux-distro.co.uk/">https://linux-distro.co.uk/</otheraddr>
</address> </address>
</listitem> </listitem>
@ -63,7 +66,8 @@
<country>United Kingdom</country> <country>United Kingdom</country>
Phone: <phone>+44 (0)247 615 8121</phone> Phone: <phone>+44 (0)247 615 8121</phone>
Fax: <fax>+44 1491 837016</fax> Fax: <fax>+44 1491 837016</fax>
WWW: <otheraddr xlink:href="http://www.linuxemporium.co.uk/products/bsd/">http://www.linuxemporium.co.uk/products/bsd/</otheraddr> WWW: <otheraddr
xlink:href="http://www.linuxemporium.co.uk/products/bsd/">http://www.linuxemporium.co.uk/products/bsd/</otheraddr>
</address> </address>
</listitem> </listitem>
@ -76,7 +80,8 @@
<country>Russia</country> <country>Russia</country>
Phone: <phone>+7-812-3125208</phone> Phone: <phone>+7-812-3125208</phone>
Email: <email>info@linuxcenter.ru</email> Email: <email>info@linuxcenter.ru</email>
WWW: <otheraddr xlink:href="http://linuxcenter.ru/shop/freebsd">http://linuxcenter.ru/shop/freebsd</otheraddr> WWW: <otheraddr
xlink:href="http://linuxcenter.ru/shop/freebsd">http://linuxcenter.ru/shop/freebsd</otheraddr>
</address> </address>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
@ -87,26 +92,28 @@
<title><acronym>FTP</acronym> Sites</title> <title><acronym>FTP</acronym> Sites</title>
<para>The official sources for &os; are available via anonymous <para>The official sources for &os; are available via anonymous
<acronym>FTP</acronym> from a worldwide set of mirror sites. The site <acronym>FTP</acronym> from a worldwide set of mirror sites.
<uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/">ftp://ftp.FreeBSD.org/pub/FreeBSD/</uri> is well The site <uri
connected and allows a large number of connections to it, but xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/">ftp://ftp.FreeBSD.org/pub/FreeBSD/</uri>
you are probably better off finding a <quote>closer</quote> is well connected and allows a large number of connections to
mirror site (especially if you decide to set up some sort of it, but you are probably better off finding a
mirror site).</para> <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 <acronym>FTP</acronym> from the <para>Additionally, &os; is available via anonymous
following mirror sites. If you choose to obtain &os; via <acronym>FTP</acronym> from the following mirror sites. If you
anonymous <acronym>FTP</acronym>, please try to use a site near you. The mirror choose to obtain &os; via anonymous <acronym>FTP</acronym>,
sites listed as <quote>Primary Mirror Sites</quote> typically please try to use a site near you. The mirror sites listed as
have the entire &os; archive (all the currently available <quote>Primary Mirror Sites</quote> typically have the entire
versions for each of the architectures) but you will probably &os; archive (all the currently available versions for each of
have faster download times from a site that is in your country the architectures) but you will probably have faster download
or region. The regional sites carry the most recent versions times from a site that is in your country or region. The
for the most popular architecture(s) but might not carry the regional sites carry the most recent versions for the most
entire &os; archive. All sites provide access via anonymous <acronym>FTP</acronym> popular architecture(s) but might not carry the entire &os;
but some sites also provide access via other methods. The archive. All sites provide access via anonymous
access methods available for each site are provided in <acronym>FTP</acronym> but some sites also provide access via
parentheses after the hostname.</para> other methods. The access methods available for each site are
provided in parentheses after the hostname.</para>
&chap.mirrors.ftp.index.inc; &chap.mirrors.ftp.index.inc;
@ -123,8 +130,8 @@
<warning> <warning>
<para>CVS has been deprecated by the project, and its use is <para>CVS has been deprecated by the project, and its use is
not recommended. not recommended. <link
<link xlink:href="&url.books.handbook;/svn.html">Subversion</link> xlink:href="&url.books.handbook;/svn.html">Subversion</link>
should be used instead.</para> should be used instead.</para>
</warning> </warning>
</sect2> </sect2>
@ -138,44 +145,44 @@
</indexterm> </indexterm>
<para><application>CTM</application> is a method for keeping a <para><application>CTM</application> is a method for keeping a
remote directory tree in sync with a central one. It is built into &os; remote directory tree in sync with a central one. It is built
and can be used to synchronize a system with &os;'s source repositories. into &os; and can be used to synchronize a system with &os;'s
It supports synchronization of an entire repository or just the specified branches.</para> 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 <para><application>CTM</application> is specifically designed for
lousy or non-existent TCP/IP connections. It provides the ability use on lousy or non-existent TCP/IP connections. It provides
for changes to be automatically sent by email. It requires the user the ability for changes to be automatically sent by email. It
to obtain up to three deltas per day for the most active requires the user to obtain up to three deltas per day for the
branches. Update sizes are always kept as most active branches. Update sizes are always kept as small as
small as possible and are typically less than 5K. About one in very ten possible and are typically less than 5K. About one in very ten
updates is 10-50K in size, and there will occasionally be an update updates is 10-50K in size, and there will occasionally be an
larger than 100K+.</para> update larger than 100K+.</para>
<para>When using <application>CTM</application> to track &os; development, <para>When using <application>CTM</application> to track &os;
refer to the development, refer to the caveats related to working directly
caveats related to working directly from the development from the development sources rather than a pre-packaged release.
sources rather than a pre-packaged release. These are discussed These are discussed in <link linkend="current-stable">Tracking
in <link linkend="current-stable">Tracking a Development Branch</link>.</para> a Development Branch</link>.</para>
<para>Little documentation exists on <para>Little documentation exists on the process of creating
the process of creating deltas or using <application>CTM</application> deltas or using <application>CTM</application> for other
for other purposes. Contact the purposes. Contact the &a.ctm-users.name; mailing list for
&a.ctm-users.name; mailing list for questions on using questions on using <application>CTM</application>.</para>
<application>CTM</application>.</para>
<sect2 xml:id="mirrors-ctm"> <sect2 xml:id="mirrors-ctm">
<title>Getting Deltas</title> <title>Getting Deltas</title>
<para>The <quote>deltas</quote> used by <para>The <quote>deltas</quote> used by
<application>CTM</application> can be obtained either through <application>CTM</application> can be obtained either through
anonymous <acronym>FTP</acronym> or anonymous <acronym>FTP</acronym> or email.</para>
email.</para>
<para><acronym>FTP</acronym> deltas can be obtained from the following mirror sites. <para><acronym>FTP</acronym> deltas can be obtained from the
When using anonymous <acronym>FTP</acronym> to obtain <application>CTM</application> deltas, following mirror sites. When using anonymous
select a geographically close mirror. <acronym>FTP</acronym> to obtain
In case of problems, contact the &a.ctm-users.name; <application>CTM</application> deltas, select a geographically
mailing list.</para> close mirror. In case of problems, contact the
&a.ctm-users.name; mailing list.</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -184,10 +191,12 @@
<listitem> <listitem>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para><uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para> <para><uri
xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>
</listitem> </listitem>
<listitem> <listitem>
<para><uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/</uri></para> <para><uri
xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/</uri></para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</listitem> </listitem>
@ -199,7 +208,8 @@
<listitem> <listitem>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para><uri xlink:href="ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/</uri></para> <para><uri
xlink:href="ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/</uri></para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</listitem> </listitem>
@ -211,99 +221,97 @@
<listitem> <listitem>
<itemizedlist> <itemizedlist>
<listitem> <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> <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>
<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> <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>
<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> <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> </listitem>
</itemizedlist> </itemizedlist>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>To instead receive deltas through email, subscribe to one of the <para>To instead receive deltas through email, subscribe to one
<literal>ctm-src</literal> distribution lists available from of the <literal>ctm-src</literal> distribution lists available
<uri xlink:href="http://lists.freebsd.org/mailman/listinfo">http://lists.freebsd.org/mailman/listinfo</uri>. For example, from <uri
&a.ctm-src-cur.name; supports the HEAD of the development xlink:href="http://lists.freebsd.org/mailman/listinfo">http://lists.freebsd.org/mailman/listinfo</uri>.
branch and &a.ctm-src-9.name; supports the 9.X release branch.</para> For example, &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 <para>As <application>CTM</application> updates arrive through
<application>CTM</application> updates arrive through email, email, use <command>ctm_rmail</command> to unpack and apply
use <command>ctm_rmail</command> to unpack and them. This command can be run directly from an entry in
apply them. This command can be run directly from an entry in <filename>/etc/aliases</filename> in order to automate this
<filename>/etc/aliases</filename> in order to process. Refer to &man.ctm.rmail.1; for more details.</para>
automate this process. Refer to
&man.ctm.rmail.1; for more
details.</para>
<note> <note>
<para>Regardless of the method which is used to get deltas, <para>Regardless of the method which is used to get deltas,
<application>CTM</application> users should subscribe <application>CTM</application> users should subscribe
to the &a.ctm-announce.name; mailing list as to the &a.ctm-announce.name; mailing list as this is the
this is the only place where announcements concerning only place where announcements concerning the operation of
the operation of the <application>CTM</application> system the <application>CTM</application> system are posted.</para>
are posted.</para>
</note> </note>
</sect2> </sect2>
<sect2> <sect2>
<title><application>CTM</application> Usage</title> <title><application>CTM</application> Usage</title>
<para>Before <application>CTM</application> <para>Before <application>CTM</application> deltas can be used
deltas can be used for the first time, a starting point for the first time, a starting point must be produced.</para>
must be produced.</para>
<para>One method is to apply a <quote>starter</quote> delta to an <para>One method is to apply a <quote>starter</quote> delta to
empty directory. A an empty directory. A starter delta can be recognized by the
starter delta can be recognized by <filename>XEmpty</filename> in its name, such as
the <filename>XEmpty</filename> in its name, such as <filename>src-cur.3210XEmpty.gz</filename>. The designation
<filename>src-cur.3210XEmpty.gz</filename>. following the <literal>X</literal> corresponds to the origin
The designation following the <literal>X</literal> corresponds of the initial <quote>seed</quote>, where
to the origin of the initial <quote>seed</quote>, where <filename>Empty</filename> is an empty directory. As a rule,
<filename>Empty</filename> is an empty directory. As a rule, a a base transition from <literal>Empty</literal> is produced
base transition from <literal>Empty</literal> is produced
every 100 deltas. Be aware that starter deltas are large and every 100 deltas. Be aware that starter deltas are large and
70 to 80 70 to 80 Megabytes of <command>gzip</command>'d data is common
Megabytes of <command>gzip</command>'d data is common for the for the <filename>XEmpty</filename> deltas.</para>
<filename>XEmpty</filename> deltas.</para>
<para>Another method is to copy or extract an initial source from <para>Another method is to copy or extract an initial source
a from a RELEASE media as this can save a significant transfer
RELEASE media as this can of data from the Internet.</para>
save a significant transfer of data from the Internet.</para>
<para>Once a base delta has been created, apply <para>Once a base delta has been created, apply all deltas with
all deltas with higher numbers. To apply the deltas:</para> higher numbers. To apply the deltas:</para>
<screen>&prompt.root; <userinput>cd /directory/to/store/the/stuff</userinput> <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> &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 <para>Multiple deltas can be applied at one time as they will
will be processed one at a time and any deltas that are already be processed one at a time and any deltas that are already
applied will be ignored. <application>CTM</application> understands deltas which applied will be ignored. <application>CTM</application>
have been put through <command>gzip</command>, which saves disk understands deltas which have been put through
space.</para> <command>gzip</command>, which saves disk space.</para>
<para>To <para>To verify a delta without applying it, include
verify a delta without applying it, include <option>-c</option>. <option>-c</option>. <application>CTM</application> will not
<application>CTM</application> will not actually touch actually touch the local tree but will instead verify the
the local tree but will instead verify the integrity of the delta integrity of the delta to see if it would apply cleanly.
to see if it would apply cleanly. Refer to &man.ctm.1; for Refer to &man.ctm.1; for more information about available
more information about available switches and an overview of switches and an overview of the process
the process <application>CTM</application> uses when applying <application>CTM</application> uses when applying
deltas.</para> deltas.</para>
<para>To keep the local source tree up-to-date, every time a <para>To keep the local source tree up-to-date, every time a
new delta becomes available, apply it through <application>CTM</application>.</para> new delta becomes available, apply it through
<application>CTM</application>.</para>
<para>Once applied, it is recommended to not delete the deltas if it is a burden to download <para>Once applied, it is recommended to not delete the deltas
them again. This way, a local copy is available in case if it is a burden to download them again. This way, a loca
something bad happens.</para> copy is available in case something bad happens.</para>
</sect2> </sect2>
<sect2> <sect2>
@ -315,76 +323,77 @@
a limited way: before checking for the presence of a file, a limited way: before checking for the presence of a file,
it first looks for a file with the same name and a it first looks for a file with the same name and a
<filename>.ctm</filename> extension. If this file exists, <filename>.ctm</filename> extension. If this file exists,
<application>CTM</application> will operate on it instead of the <application>CTM</application> will operate on it instead of
original filename.</para> the original filename.</para>
<para>This behavior provides a simple way to maintain local <para>This behavior provides a simple way to maintain local
changes. Before modifying a file, make a copy with a changes. Before modifying a file, make a copy with a
<filename>.ctm</filename> <filename>.ctm</filename> suffix. Make any changes to the
suffix. Make any changes to the original filename, knowing that original filename, knowing that
<application>CTM</application> will only apply updates to the file with the <application>CTM</application> will only apply updates to the
<filename>.ctm</filename> suffix.</para> file with the <filename>.ctm</filename> suffix.</para>
</sect2> </sect2>
<sect2> <sect2>
<title>Other <application>CTM</application> <title>Other <application>CTM</application> Options</title>
Options</title>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>Finding Out Exactly What Would Be Touched by an <term>Finding Out Exactly What Would Be Touched by an
Update</term> Update</term>
<listitem> <listitem>
<para>To determine the list of changes that <para>To determine the list of changes that
<application>CTM</application> will make to the local source <application>CTM</application> will make to the local
repository, use <option>-l</option>. This option is useful for creating logs of the source repository, use <option>-l</option>. This option
changes or when performing pre- or post-processing on any of the modified files.</para> is useful for creating logs of the changes or when
</listitem> performing pre- or post-processing on any of the
</varlistentry> modified files.</para>
</listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term>Making Backups Before Updating</term> <term>Making Backups Before Updating</term>
<listitem> <listitem>
<para>To backup all of the files that <para>To backup all of the files that would be changed by
would be changed by a <application>CTM</application> a <application>CTM</application> update, specify
update, specify <option>-B backup-file</option>. This option <option>-B backup-file</option>. This option tells
tells <application>CTM</application> to backup all files <application>CTM</application> to backup all files
touched by the applied touched by the applied <application>CTM</application>
<application>CTM</application> delta to delta to <filename>backup-file</filename>.</para>
<filename>backup-file</filename>.</para> </listitem>
</listitem> </varlistentry>
</varlistentry>
<varlistentry> <varlistentry>
<term>Restricting the Files Touched by an Update</term> <term>Restricting the Files Touched by an Update</term>
<listitem> <listitem>
<para>To restrict the <para>To restrict the scope of a given
scope of a given <application>CTM</application> update, or <application>CTM</application> update, or to extract
to extract just a few files from a just a few files from a sequence of deltas, filtering
sequence of deltas, regular expressions can be specified using
filtering regular expressions can be specified using <option>-e</option>, which specifies which files to
<option>-e</option>, which specifies which files to process, or <option>-x</option>, which specifies which files to ignore.</para> process, or <option>-x</option>, which specifies which
files to ignore.</para>
<para>For example, to extract an up-to-date copy of <para>For example, to extract an up-to-date copy of
<filename>lib/libc/Makefile</filename> from a collection <filename>lib/libc/Makefile</filename> from a collection
of saved <application>CTM</application> deltas:</para> of saved <application>CTM</application> deltas:</para>
<screen>&prompt.root; <userinput>cd /directory/to/extract/to/</userinput> <screen>&prompt.root; <userinput>cd /directory/to/extract/to/</userinput>
&prompt.root; <userinput>ctm -e '^lib/libc/Makefile' /directory/which/stores/the/deltas/src-xxx.*</userinput></screen> &prompt.root; <userinput>ctm -e '^lib/libc/Makefile' /directory/which/stores/the/deltas/src-xxx.*</userinput></screen>
<para>For every file specified in a <para>For every file specified in a
<application>CTM</application> delta, <application>CTM</application> delta,
<option>-e</option> and <option>-x</option> are <option>-e</option> and <option>-x</option> are
applied in the order given on the command line. A file is applied in the order given on the command line. A file
processed by <application>CTM</application> only if it is is processed by <application>CTM</application> only if
marked as eligible after all <option>-e</option> and it is marked as eligible after all <option>-e</option>
<option>-x</option> options are applied.</para> and <option>-x</option> options are applied.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
<!-- <!--
Comment out for now until these can be verified. Comment out for now until these can be verified.
@ -425,15 +434,18 @@ Comment out for now until these can be verified.
<sect2 xml:id="svn-intro"> <sect2 xml:id="svn-intro">
<title>Introduction</title> <title>Introduction</title>
<para>As of July 2012, &os; uses <link xlink:href="http://subversion.apache.org/">Subversion</link> <para>As of July 2012, &os; uses <link
xlink:href="http://subversion.apache.org/">Subversion</link>
(<emphasis>svn</emphasis>) as the primary version control (<emphasis>svn</emphasis>) as the primary version control
system for storing all of &os;'s source code, documentation, system for storing all of &os;'s source code, documentation,
and the Ports Collection.</para> and the Ports Collection.</para>
<note> <note>
<para>Subversion is generally a developer tool. Most users <para>Subversion is generally a developer tool. Most users
should use <link linkend="updating-upgrading-freebsdupdate">FreeBSD should use <link
Update</link> to update the &os; base system, and <link linkend="ports-using">Portsnap</link> to linkend="updating-upgrading-freebsdupdate">FreeBSD
Update</link> to update the &os; base system, and <link
linkend="ports-using">Portsnap</link> to
update the &os; Ports Collection.</para> update the &os; Ports Collection.</para>
</note> </note>
@ -448,8 +460,9 @@ Comment out for now until these can be verified.
documentation. For example, the URL documentation. For example, the URL
<literal>svn://svn0.us-east.FreeBSD.org/ports/head/</literal> <literal>svn://svn0.us-east.FreeBSD.org/ports/head/</literal>
specifies the main branch of the ports repository on the specifies the main branch of the ports repository on the
<systemitem class="fqdomainname">svn0.us-east.FreeBSD.org</systemitem> mirror, <systemitem
using the <literal>svn</literal> protocol.</para> class="fqdomainname">svn0.us-east.FreeBSD.org</systemitem>
mirror, using the <literal>svn</literal> protocol.</para>
</sect2> </sect2>
<sect2 xml:id="svn-install"> <sect2 xml:id="svn-install">
@ -591,9 +604,9 @@ Comment out for now until these can be verified.
<para>For other information about using <para>For other information about using
<application>Subversion</application>, please see the <application>Subversion</application>, please see the
<quote>Subversion Book</quote>, titled <quote>Subversion Book</quote>, titled
<link xlink:href="http://svnbook.red-bean.com/">Version Control with <link xlink:href="http://svnbook.red-bean.com/">Version
Subversion</link>, or the Control with Subversion</link>, or the <link
<link xlink:href="http://subversion.apache.org/docs/">Subversion xlink:href="http://subversion.apache.org/docs/">Subversion
Documentation</link>.</para> Documentation</link>.</para>
</sect2> </sect2>
</sect1> </sect1>
@ -609,11 +622,13 @@ Comment out for now until these can be verified.
<para>All mirrors carry all repositories.</para> <para>All mirrors carry all repositories.</para>
<para>The master &os; <application>Subversion</application> <para>The master &os; <application>Subversion</application>
server, <systemitem class="fqdomainname">svn.FreeBSD.org</systemitem>, is server, <systemitem
class="fqdomainname">svn.FreeBSD.org</systemitem>, is
publicly accessible, read-only. That may change in the future, publicly accessible, read-only. That may change in the future,
so users are encouraged to use one of the official mirrors. To so users are encouraged to use one of the official mirrors. To
view the &os; <application>Subversion</application> repositories view the &os; <application>Subversion</application> repositories
through a browser, use <link xlink:href="http://svnweb.FreeBSD.org/">http://svnweb.FreeBSD.org/</link>.</para> through a browser, use <link
xlink:href="http://svnweb.FreeBSD.org/">http://svnweb.FreeBSD.org/</link>.</para>
<note> <note>
<para>The &os; svn mirror network is still in its early days, <para>The &os; svn mirror network is still in its early days,
@ -642,10 +657,13 @@ Comment out for now until these can be verified.
<tbody> <tbody>
<row> <row>
<entry><systemitem class="fqdomainname">svn0.us-west.FreeBSD.org</systemitem></entry> <entry><systemitem
class="fqdomainname">svn0.us-west.FreeBSD.org</systemitem></entry>
<entry>svn, <link xlink:href="http://svn0.us-west.FreeBSD.org/">http</link>, <entry>svn, <link
<link xlink:href="https://svn0.us-west.FreeBSD.org/">https</link></entry> xlink:href="http://svn0.us-west.FreeBSD.org/">http</link>,
<link
xlink:href="https://svn0.us-west.FreeBSD.org/">https</link></entry>
<entry>USA, California</entry> <entry>USA, California</entry>
@ -654,10 +672,14 @@ Comment out for now until these can be verified.
</row> </row>
<row> <row>
<entry><systemitem class="fqdomainname">svn0.us-east.FreeBSD.org</systemitem></entry> <entry><systemitem
class="fqdomainname">svn0.us-east.FreeBSD.org</systemitem></entry>
<entry>svn, <link xlink:href="http://svn0.us-east.FreeBSD.org/">http</link>, <entry>svn, <link
<link xlink:href="https://svn0.us-east.FreeBSD.org/">https</link>, rsync</entry> xlink:href="http://svn0.us-east.FreeBSD.org/">http</link>,
<link
xlink:href="https://svn0.us-east.FreeBSD.org/">https</link>,
rsync</entry>
<entry>USA, New Jersey</entry> <entry>USA, New Jersey</entry>
@ -666,10 +688,14 @@ Comment out for now until these can be verified.
</row> </row>
<row> <row>
<entry><systemitem class="fqdomainname">svn0.eu.FreeBSD.org</systemitem></entry> <entry><systemitem
class="fqdomainname">svn0.eu.FreeBSD.org</systemitem></entry>
<entry>svn, <link xlink:href="http://svn0.eu.FreeBSD.org/">http</link>, <entry>svn, <link
<link xlink:href="https://svn0.eu.FreeBSD.org/">https</link>, rsync</entry> xlink:href="http://svn0.eu.FreeBSD.org/">http</link>,
<link
xlink:href="https://svn0.eu.FreeBSD.org/">https</link>,
rsync</entry>
<entry>Europe, UK</entry> <entry>Europe, UK</entry>
@ -778,13 +804,13 @@ Certificate information:
<para>The easiest way to install <para>The easiest way to install
<application>CVSup</application> is to use the precompiled <application>CVSup</application> is to use the precompiled
<package>net/cvsup</package> package from the <package>net/cvsup</package> package from the &os; <link
&os; <link linkend="ports">packages collection</link>. If you linkend="ports">packages collection</link>. If you
prefer to build <application>CVSup</application> from source, prefer to build <application>CVSup</application> from source,
you can use the <package>net/cvsup</package> you can use the <package>net/cvsup</package> port instead.
port instead. But be forewarned: the <package>net/cvsup</package> port depends on the But be forewarned: the <package>net/cvsup</package> port
Modula-3 system, which takes a substantial amount of time and depends on the Modula-3 system, which takes a substantial
disk space to download and build.</para> amount of time and disk space to download and build.</para>
<note> <note>
<para>If you are going to be using <para>If you are going to be using
@ -802,7 +828,8 @@ Certificate information:
<para><application>CVSup</application>'s operation is controlled <para><application>CVSup</application>'s operation is controlled
by a configuration file called the by a configuration file called the
<filename>supfile</filename>. There are some sample <filename>supfile</filename>. There are some sample
<filename>supfiles</filename> in the directory <link xlink:href="file://localhost/usr/share/examples/cvsup/"><filename>/usr/share/examples/cvsup/</filename></link>.</para> <filename>supfiles</filename> in the directory <link
xlink:href="file://localhost/usr/share/examples/cvsup/"><filename>/usr/share/examples/cvsup/</filename></link>.</para>
<para>The information in a <filename>supfile</filename> answers <para>The information in a <filename>supfile</filename> answers
the following questions for the following questions for
@ -884,8 +911,8 @@ Certificate information:
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para><anchor xml:id="cvsup-config-files"/>Which files do you <para><anchor xml:id="cvsup-config-files"/>Which files do
want to receive?</para> you want to receive?</para>
<para>The files available via <para>The files available via
<application>CVSup</application> are organized into named <application>CVSup</application> are organized into named
@ -904,8 +931,8 @@ Certificate information:
</listitem> </listitem>
<listitem> <listitem>
<para><anchor xml:id="cvsup-config-vers"/>Which version(s) of <para><anchor xml:id="cvsup-config-vers"/>Which version(s)
them do you want?</para> of them do you want?</para>
<para>With <application>CVSup</application>, you can receive <para>With <application>CVSup</application>, you can receive
virtually any version of the sources that ever existed. virtually any version of the sources that ever existed.
@ -983,17 +1010,17 @@ Certificate information:
</listitem> </listitem>
<listitem> <listitem>
<para><anchor xml:id="cvsup-config-where"/>Where do you want to <para><anchor xml:id="cvsup-config-where"/>Where do you want
get them from?</para> to get them from?</para>
<para>We use the <literal>host=</literal> field to tell <para>We use the <literal>host=</literal> field to tell
<command>cvsup</command> where to obtain its updates. Any <command>cvsup</command> where to obtain its updates. Any
of the of the <link
<link linkend="cvsup-mirrors">CVSup mirror sites</link> linkend="cvsup-mirrors">CVSup mirror sites</link> will
will do, though you should try to select one that is close do, though you should try to select one that is close to
to you in cyberspace. In this example we will use a you in cyberspace. In this example we will use a
fictional &os; distribution site, fictional &os; distribution site, <systemitem
<systemitem class="fqdomainname">cvsup99.FreeBSD.org</systemitem>:</para> class="fqdomainname">cvsup99.FreeBSD.org</systemitem>:</para>
<programlisting>*default host=cvsup99.FreeBSD.org</programlisting> <programlisting>*default host=cvsup99.FreeBSD.org</programlisting>
@ -1006,8 +1033,8 @@ Certificate information:
</listitem> </listitem>
<listitem> <listitem>
<para><anchor xml:id="cvsup-config-dest"/>Where do you want to <para><anchor xml:id="cvsup-config-dest"/>Where do you want
put them on your own machine?</para> to put them on your own machine?</para>
<para>The <literal>prefix=</literal> field tells <para>The <literal>prefix=</literal> field tells
<command>cvsup</command> where to put the files it <command>cvsup</command> where to put the files it
@ -1160,7 +1187,8 @@ usr.bin/</programlisting>
<para>Since you are updating your actual <para>Since you are updating your actual
<filename>/usr/src</filename> tree in this example, you will <filename>/usr/src</filename> tree in this example, you will
need to run the program as <systemitem class="username">root</systemitem> so that need to run the program as <systemitem
class="username">root</systemitem> so that
<command>cvsup</command> has the permissions it needs to <command>cvsup</command> has the permissions it needs to
update your files. Having just created your configuration update your files. Having just created your configuration
file, and having never used this program before, that might file, and having never used this program before, that might
@ -1183,8 +1211,8 @@ usr.bin/</programlisting>
versions of those files will be written into the specified versions of those files will be written into the specified
directory. As long as you have read access to directory. As long as you have read access to
<filename>/usr/src</filename>, you do not even need to be <filename>/usr/src</filename>, you do not even need to be
<systemitem class="username">root</systemitem> to perform this kind of trial <systemitem class="username">root</systemitem> to perform this
run.</para> kind of trial run.</para>
<para>If you are not running X11 or if you just do not like <para>If you are not running X11 or if you just do not like
GUIs, you should add a couple of options to the command line GUIs, you should add a couple of options to the command line
@ -2000,16 +2028,15 @@ usr.bin/</programlisting>
particular version of &os; was released. The release particular version of &os; was released. The release
engineering process is documented in more detail by the engineering process is documented in more detail by the
<link xlink:href="&url.base;/releng/">Release Engineering <link xlink:href="&url.base;/releng/">Release Engineering
Information</link> and Information</link> and <link
<link xlink:href="&url.articles.releng;/release-proc.html">Release xlink:href="&url.articles.releng;/release-proc.html">Release
Process</link> documents. The Process</link> documents. The
<filename>src</filename> tree uses tag names <filename>src</filename> tree uses tag names
that start with <literal>RELENG_</literal> tags. The that start with <literal>RELENG_</literal> tags. The
<filename>ports</filename> and <filename>ports</filename> and <filename>doc</filename> trees
<filename>doc</filename> trees use tags use tags whose names begin with <literal>RELEASE</literal>
whose names begin with <literal>RELEASE</literal> tags. tags. Finally, the <filename>www</filename> tree is not
Finally, the <filename>www</filename> tree tagged with any special name for releases.</para>
is not tagged with any special name for releases.</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -2457,12 +2484,13 @@ usr.bin/</programlisting>
<para>Available collections:</para> <para>Available collections:</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>ftp: A partial mirror of the &os; <acronym>FTP</acronym> <para>ftp: A partial mirror of the &os;
server.</para> <acronym>FTP</acronym> server.</para>
</listitem> </listitem>
<listitem> <listitem>
<para>&os;: A full mirror of the &os; <acronym>FTP</acronym> server.</para> <para>&os;: A full mirror of the &os;
<acronym>FTP</acronym> server.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</listitem> </listitem>
@ -2477,7 +2505,8 @@ usr.bin/</programlisting>
<para>Available collections:</para> <para>Available collections:</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>&os;: A full mirror of the &os; <acronym>FTP</acronym> server.</para> <para>&os;: A full mirror of the &os;
<acronym>FTP</acronym> server.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</listitem> </listitem>
@ -2493,7 +2522,8 @@ usr.bin/</programlisting>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>&os;: A full mirror of the &os; <acronym>FTP</acronym> server.</para> <para>&os;: A full mirror of the &os;
<acronym>FTP</acronym> server.</para>
</listitem> </listitem>
<listitem> <listitem>
@ -2518,7 +2548,8 @@ usr.bin/</programlisting>
<para>Available collections:</para> <para>Available collections:</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>&os;: A full mirror of the &os; <acronym>FTP</acronym> server.</para> <para>&os;: A full mirror of the &os;
<acronym>FTP</acronym> server.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</listitem> </listitem>
@ -2537,7 +2568,8 @@ usr.bin/</programlisting>
<para>Available collections:</para> <para>Available collections:</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>&os;: A full mirror of the &os; <acronym>FTP</acronym> server.</para> <para>&os;: A full mirror of the &os;
<acronym>FTP</acronym> server.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</listitem> </listitem>
@ -2570,8 +2602,8 @@ usr.bin/</programlisting>
<para>Available collections:</para> <para>Available collections:</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>&os;: The master archive of the &os; <acronym>FTP</acronym> <para>&os;: The master archive of the &os;
server.</para> <acronym>FTP</acronym> server.</para>
</listitem> </listitem>
<listitem> <listitem>
@ -2585,7 +2617,8 @@ usr.bin/</programlisting>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>&os;: A full mirror of the &os; <acronym>FTP</acronym> server.</para> <para>&os;: A full mirror of the &os;
<acronym>FTP</acronym> server.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</listitem> </listitem>