diff options
author | Warren Block <wblock@FreeBSD.org> | 2012-10-10 23:14:38 +0000 |
---|---|---|
committer | Warren Block <wblock@FreeBSD.org> | 2012-10-10 23:14:38 +0000 |
commit | 4b5a930ee77474dfc58cc35749085dc6c4b9d578 (patch) | |
tree | 3ceeb59663bed9cfaa2de2767cad318469aaee4c /en_US.ISO8859-1/books | |
parent | 6c84a1d9f8e80050e684cf600fb164b874e6e030 (diff) | |
download | doc-4b5a930ee77474dfc58cc35749085dc6c4b9d578.tar.gz doc-4b5a930ee77474dfc58cc35749085dc6c4b9d578.zip |
Whitespace-only cleanup, fixing indentation and long line wrap.
Translators, please ignore.
Notes
Notes:
svn path=/head/; revision=39731
Diffstat (limited to 'en_US.ISO8859-1/books')
-rw-r--r-- | en_US.ISO8859-1/books/handbook/mirrors/chapter.xml | 3235 |
1 files changed, 1671 insertions, 1564 deletions
diff --git a/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml b/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml index f7421e5581..89f757fe65 100644 --- a/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml +++ b/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml @@ -22,7 +22,8 @@ <listitem> <address> <otheraddr>Frys Electronics</otheraddr> - WWW: <otheraddr><ulink url="http://www.frys.com/"></ulink></otheraddr> + WWW: <otheraddr><ulink + url="http://www.frys.com/"></ulink></otheraddr> </address> </listitem> </itemizedlist> @@ -34,129 +35,143 @@ <para>&os; CD and DVD sets are available from many online retailers:</para> - <itemizedlist> - <listitem> - <address> - <otheraddr>&os; Mall, Inc.</otheraddr> - <street>700 Harvest Park Ste F</street> - <city>Brentwood</city>, <state>CA</state> <postcode>94513</postcode> - <country>USA</country> - Phone: <phone>+1 925 240-6652</phone> - Fax: <fax>+1 925 674-0821</fax> - Email: <email>info@freebsdmall.com</email> - WWW: <otheraddr><ulink url="http://www.freebsdmall.com/"></ulink></otheraddr> - </address> - </listitem> - - <listitem> - <address> - <otheraddr>Dr. Hinner EDV</otheraddr> - <street>St. Augustinus-Str. 10</street> - <postcode>D-81825</postcode> <city>München</city> - <country>Germany</country> - Phone: <phone>(089) 428 419</phone> - WWW: <otheraddr><ulink url="http://www.hinner.de/linux/freebsd.html"></ulink></otheraddr> - </address> - </listitem> - - <listitem> - <address> - <otheraddr>JMC Software</otheraddr> - <country>Ireland</country> - Phone: <phone>353 1 6291282</phone> - WWW: <otheraddr><ulink url="http://www.thelinuxmall.com"></ulink></otheraddr> - </address> - </listitem> - - <listitem> - <address> - <otheraddr>Linux Distro UK</otheraddr> - <street>42 Wharfedale Road</street> - <city>Margate</city> - <postcode>CT9 2TB</postcode> - <country>United Kingdom</country> - WWW: <otheraddr><ulink url="https://linux-distro.co.uk/"></ulink></otheraddr> - </address> - </listitem> - - <listitem> - <address> - <otheraddr>The Linux Emporium</otheraddr> - <street>Hilliard House, Lester Way</street> - <city>Wallingford</city> - <postcode>OX10 9TA</postcode> - <country>United Kingdom</country> - Phone: <phone>+44 1491 837010</phone> - Fax: <fax>+44 1491 837016</fax> - WWW: <otheraddr><ulink url="http://www.linuxemporium.co.uk/products/bsd/"></ulink></otheraddr> - </address> - </listitem> - - <listitem> - <address> - <otheraddr>Linux+ DVD Magazine</otheraddr> - <street>Lewartowskiego 6</street> - <city>Warsaw</city> - <postcode>00-190</postcode> - <country>Poland</country> - Phone: <phone>+48 22 860 18 18</phone> - Email: <email>editors@lpmagazine.org</email> - WWW: <otheraddr><ulink url="http://www.lpmagazine.org/"></ulink></otheraddr> - </address> - </listitem> - - <listitem> - <address> - <otheraddr>Linux System Labs Australia</otheraddr> - <street>21 Ray Drive</street> - <city>Balwyn North</city> - <postcode>VIC - 3104</postcode> - <country>Australia</country> - Phone: <phone>+61 3 9857 5918</phone> - Fax: <fax>+61 3 9857 8974</fax> - WWW: <otheraddr><ulink url="http://www.lsl.com.au"></ulink></otheraddr> - </address> - </listitem> - - <listitem> - <address> - <otheraddr>LinuxCenter.Ru</otheraddr> - <street>Galernaya Street, 55</street> - <city>Saint-Petersburg</city> - <postcode>190000</postcode> - <country>Russia</country> - Phone: <phone>+7-812-3125208</phone> - Email: <email>info@linuxcenter.ru</email> - WWW: <otheraddr><ulink url="http://linuxcenter.ru/shop/freebsd"></ulink></otheraddr> - </address> - </listitem> - - </itemizedlist> + <itemizedlist> + <listitem> + <address> + <otheraddr>&os; Mall, Inc.</otheraddr> + <street>700 Harvest Park Ste F</street> + <city>Brentwood</city>, + <state>CA</state> + <postcode>94513</postcode> + <country>USA</country> + Phone: <phone>+1 925 240-6652</phone> + Fax: <fax>+1 925 674-0821</fax> + Email: <email>info@freebsdmall.com</email> + WWW: <otheraddr><ulink + url="http://www.freebsdmall.com/"></ulink></otheraddr> + </address> + </listitem> + + <listitem> + <address> + <otheraddr>Dr. Hinner EDV</otheraddr> + <street>St. Augustinus-Str. 10</street> + <postcode>D-81825</postcode> <city>München</city> + <country>Germany</country> + Phone: <phone>(089) 428 419</phone> + WWW: <otheraddr><ulink + url="http://www.hinner.de/linux/freebsd.html"></ulink></otheraddr> + </address> + </listitem> + + <listitem> + <address> + <otheraddr>JMC Software</otheraddr> + <country>Ireland</country> + Phone: <phone>353 1 6291282</phone> + WWW: <otheraddr><ulink + url="http://www.thelinuxmall.com"></ulink></otheraddr> + </address> + </listitem> + + <listitem> + <address> + <otheraddr>Linux Distro UK</otheraddr> + <street>42 Wharfedale Road</street> + <city>Margate</city> + <postcode>CT9 2TB</postcode> + <country>United Kingdom</country> + WWW: <otheraddr><ulink + url="https://linux-distro.co.uk/"></ulink></otheraddr> + </address> + </listitem> + + <listitem> + <address> + <otheraddr>The Linux Emporium</otheraddr> + <street>Hilliard House, Lester Way</street> + <city>Wallingford</city> + <postcode>OX10 9TA</postcode> + <country>United Kingdom</country> + Phone: <phone>+44 1491 837010</phone> + Fax: <fax>+44 1491 837016</fax> + WWW: <otheraddr><ulink + url="http://www.linuxemporium.co.uk/products/bsd/"></ulink></otheraddr> + </address> + </listitem> + + <listitem> + <address> + <otheraddr>Linux+ DVD Magazine</otheraddr> + <street>Lewartowskiego 6</street> + <city>Warsaw</city> + <postcode>00-190</postcode> + <country>Poland</country> + Phone: <phone>+48 22 860 18 18</phone> + Email: <email>editors@lpmagazine.org</email> + WWW: <otheraddr><ulink + url="http://www.lpmagazine.org/"></ulink></otheraddr> + </address> + </listitem> + + <listitem> + <address> + <otheraddr>Linux System Labs Australia</otheraddr> + <street>21 Ray Drive</street> + <city>Balwyn North</city> + <postcode>VIC - 3104</postcode> + <country>Australia</country> + Phone: <phone>+61 3 9857 5918</phone> + Fax: <fax>+61 3 9857 8974</fax> + WWW: <otheraddr><ulink + url="http://www.lsl.com.au"></ulink></otheraddr> + </address> + </listitem> + + <listitem> + <address> + <otheraddr>LinuxCenter.Ru</otheraddr> + <street>Galernaya Street, 55</street> + <city>Saint-Petersburg</city> + <postcode>190000</postcode> + <country>Russia</country> + Phone: <phone>+7-812-3125208</phone> + Email: <email>info@linuxcenter.ru</email> + WWW: <otheraddr><ulink + url="http://linuxcenter.ru/shop/freebsd"></ulink></otheraddr> + </address> + </listitem> + </itemizedlist> </sect2> <sect2> <title>Distributors</title> - <para>If you are a reseller and want to carry &os; CDROM products, - please contact a distributor:</para> + <para>If you are a reseller and want to carry &os; CDROM + products, please contact a distributor:</para> <itemizedlist> - <listitem> + <listitem> <address> <otheraddr>Ingram Micro</otheraddr> <street>1600 E. St. Andrew Place</street> - <city>Santa Ana</city>, <state>CA</state> <postcode>92705-4926</postcode> + <city>Santa Ana</city>, + <state>CA</state> + <postcode>92705-4926</postcode> <country>USA</country> Phone: <phone>1 (800) 456-8000</phone> - WWW: <otheraddr><ulink url="http://www.ingrammicro.com/"></ulink></otheraddr> - </address> - </listitem> + WWW: <otheraddr><ulink + url="http://www.ingrammicro.com/"></ulink></otheraddr> + </address> + </listitem> <listitem> <address> <otheraddr>Kudzu, LLC</otheraddr> <street>7375 Washington Ave. S.</street> - <city>Edina</city>, <state>MN</state> <postcode>55439</postcode> + <city>Edina</city>, + <state>MN</state> + <postcode>55439</postcode> <country>USA</country> Phone: <phone>+1 952 947-0822</phone> Fax: <fax>+1 952 947-0876</fax> @@ -173,7 +188,8 @@ <country>Russia</country> Phone: <phone>+7-812-3125208</phone> Email: <email>info@linuxcenter.ru</email> - WWW: <otheraddr><ulink url="http://linuxcenter.ru/freebsd"></ulink></otheraddr> + WWW: <otheraddr><ulink + url="http://linuxcenter.ru/freebsd"></ulink></otheraddr> </address> </listitem> </itemizedlist> @@ -183,8 +199,8 @@ <sect1 id="mirrors-ftp"> <title>FTP Sites</title> - <para>The official sources for &os; are available via anonymous FTP - from a worldwide set of mirror sites. The site + <para>The official sources for &os; are available via anonymous + FTP from a worldwide set of mirror sites. The site <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/"></ulink> is well connected and allows a large number of connections to it, but you are probably better off finding a <quote>closer</quote> @@ -192,17 +208,18 @@ mirror site).</para> <para>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 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 but some sites also provide access via other methods. The access - methods available for each site are provided in parentheses - after the hostname.</para> + following mirror sites. If you choose to obtain &os; via + anonymous FTP, 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 + but some sites also provide access via other methods. The + access methods available for each site are provided in + parentheses after the hostname.</para> &chap.mirrors.ftp.inc; </sect1> @@ -217,15 +234,15 @@ <para>The ISO images for the basic release CDs are available via BitTorrent. A collection of torrent files to download the images is available at <ulink - url="http://torrents.freebsd.org:8080/">http://torrents.freebsd.org:8080</ulink></para> + url="http://torrents.freebsd.org:8080/">http://torrents.freebsd.org:8080</ulink></para> <para>The BitTorrent client software is available from the <filename role="package">net-p2p/py-bittorrent</filename> port, or a precompiled package.</para> <para>After downloading the ISO image with BitTorrent, you may - burn it to CD or DVD media as described in <xref - linkend="burncd"/>, burncd.</para> + burn it to CD or DVD media as described in + <xref linkend="burncd"/>, burncd.</para> </sect1> <sect1 id="mirrors-svn"> @@ -330,569 +347,595 @@ </informaltable> </sect1> - <sect1 id="anoncvs"> - <title>Anonymous CVS</title> - - <sect2> - <title><anchor id="anoncvs-intro"/>Introduction</title> - - <indexterm> - <primary>CVS</primary> - <secondary>anonymous</secondary> - </indexterm> - - <para>Anonymous CVS (or, as it is otherwise known, - <emphasis>anoncvs</emphasis>) is a feature provided by the CVS - utilities bundled with &os; for synchronizing with a remote - CVS repository. Among other things, it allows users of &os; - to perform, with no special privileges, read-only CVS operations - against one of the &os; project's official anoncvs servers. - To use it, one simply sets the <envar>CVSROOT</envar> - environment variable to point at the appropriate anoncvs server, - provides the well-known password <quote>anoncvs</quote> with the - <command>cvs login</command> command, and then uses the - &man.cvs.1; command to access it like any local - repository.</para> - - <note> - <para>The <command>cvs login</command> command, stores the passwords - that are used for authenticating to the CVS server in a file - called <filename>.cvspass</filename> in your - <envar>HOME</envar> directory. If this file does not exist, - you might get an error when trying to use <command>cvs - login</command> for the first time. Just make an empty - <filename>.cvspass</filename> file, and retry to login.</para> - </note> - - <para>While it can also be said that the <link - linkend="cvsup">CVSup</link> and <emphasis>anoncvs</emphasis> - services both perform essentially the same function, there are - various trade-offs which can influence the user's choice of - synchronization methods. In a nutshell, - <application>CVSup</application> is much more efficient in its - usage of network resources and is by far the most technically - sophisticated of the two, but at a price. To use - <application>CVSup</application>, a special client must first be - installed and configured before any bits can be grabbed, and - then only in the fairly large chunks which - <application>CVSup</application> calls - <emphasis>collections</emphasis>.</para> - - <para><application>Anoncvs</application>, by contrast, can be used - to examine anything from an individual file to a specific - program (like <command>ls</command> or <command>grep</command>) - by referencing the CVS module name. Of course, - <application>anoncvs</application> is also only good for - read-only operations on the CVS repository, so if it is your - intention to support local development in one repository shared - with the &os; project bits then - <application>CVSup</application> is really your only - option.</para> - </sect2> - - <sect2> - <title><anchor id="anoncvs-usage"/>Using Anonymous CVS</title> - - <para>Configuring &man.cvs.1; to use an Anonymous CVS repository - is a simple matter of setting the <envar>CVSROOT</envar> - environment variable to point to one of the &os; project's - <emphasis>anoncvs</emphasis> servers. At the time of this - writing, the following servers are available:</para> - - <itemizedlist> - <listitem> - <para><emphasis>France</emphasis>: - :pserver:anoncvs@anoncvs.fr.FreeBSD.org:/home/ncvs - (For pserver mode, use <command>cvs login</command> and - enter the password <quote>anoncvs</quote> when prompted. - For ssh, no password is required.)</para> - </listitem> - <!-- - <listitem> - <para><emphasis>Japan</emphasis>: - :pserver:anoncvs@anoncvs.jp.FreeBSD.org:/home/ncvs - (Use <command>cvs login</command> and enter the password - <quote>anoncvs</quote> when prompted.)</para> - </listitem> - --> - <listitem> - <para><emphasis>Taiwan</emphasis>: - :pserver:anoncvs@anoncvs.tw.FreeBSD.org:/home/ncvs - (For pserver mode, use <command>cvs login</command> and - enter any password when prompted. For ssh, no password - is required.)</para> - - <programlisting>SSH2 HostKey: 1024 02:ed:1b:17:d6:97:2b:58:5e:5c:e2:da:3b:89:88:26 /etc/ssh/ssh_host_rsa_key.pub -SSH2 HostKey: 1024 e8:3b:29:7b:ca:9f:ac:e9:45:cb:c8:17:ae:9b:eb:55 /etc/ssh/ssh_host_dsa_key.pub</programlisting> + <sect1 id="anoncvs"> + <title>Anonymous CVS</title> - </listitem> - <!-- - <listitem> - <para><emphasis>USA</emphasis>: - anoncvs@anoncvs1.FreeBSD.org:/home/ncvs (For ssh, use ssh - version 2 and no password is required.)</para> + <sect2> + <title><anchor id="anoncvs-intro"/>Introduction</title> - <programlisting>SSH2 HostKey: 2048 53:1f:15:a3:72:5c:43:f6:44:0e:6a:e9:bb:f8:01:62 /etc/ssh/ssh_host_dsa_key.pub</programlisting> + <indexterm> + <primary>CVS</primary> + <secondary>anonymous</secondary> + </indexterm> - </listitem> - --> - </itemizedlist> + <para>Anonymous CVS (or, as it is otherwise known, + <emphasis>anoncvs</emphasis>) is a feature provided by the CVS + utilities bundled with &os; for synchronizing with a remote + CVS repository. Among other things, it allows users of &os; + to perform, with no special privileges, read-only CVS + operations against one of the &os; project's official anoncvs + servers. To use it, one simply sets the + <envar>CVSROOT</envar> environment variable to point at the + appropriate anoncvs server, provides the well-known password + <quote>anoncvs</quote> with the <command>cvs login</command> + command, and then uses the &man.cvs.1; command to access it + like any local repository.</para> - <para>Since CVS allows one to <quote>check out</quote> virtually - any version of the &os; sources that ever existed (or, in - some cases, will exist), you need to be - familiar with the revision (<option>-r</option>) flag to - &man.cvs.1; and what some of the permissible values for it in - the &os; Project repository are.</para> + <note> + <para>The <command>cvs login</command> command, stores the + passwords that are used for authenticating to the CVS server + in a file called <filename>.cvspass</filename> in your + <envar>HOME</envar> directory. If this file does not exist, + you might get an error when trying to use + <command>cvs login</command> for the first time. Just make + an empty <filename>.cvspass</filename> file, and retry to + login.</para> + </note> - <para>There are two kinds of tags, revision tags and branch tags. - A revision tag refers to a specific revision. Its meaning stays - the same from day to day. A branch tag, on the other hand, - refers to the latest revision on a given line of development, at - any given time. Because a branch tag does not refer to a - specific revision, it may mean something different tomorrow than - it means today.</para> + <para>While it can also be said that the + <link linkend="cvsup">CVSup</link> and + <emphasis>anoncvs</emphasis> services both perform essentially + the same function, there are various trade-offs which can + influence the user's choice of synchronization methods. In a + nutshell, <application>CVSup</application> is much more + efficient in its usage of network resources and is by far the + most technically sophisticated of the two, but at a price. To + use <application>CVSup</application>, a special client must + first be installed and configured before any bits can be + grabbed, and then only in the fairly large chunks which + <application>CVSup</application> calls + <emphasis>collections</emphasis>.</para> + + <para><application>Anoncvs</application>, by contrast, can be + used to examine anything from an individual file to a specific + program (like <command>ls</command> or + <command>grep</command>) by referencing the CVS module name. + Of course, <application>anoncvs</application> is also only + good for read-only operations on the CVS repository, so if it + is your intention to support local development in one + repository shared with the &os; project bits then + <application>CVSup</application> is really your only + option.</para> + </sect2> + + <sect2> + <title><anchor id="anoncvs-usage"/>Using Anonymous CVS</title> + + <para>Configuring &man.cvs.1; to use an Anonymous CVS repository + is a simple matter of setting the <envar>CVSROOT</envar> + environment variable to point to one of the &os; project's + <emphasis>anoncvs</emphasis> servers. At the time of this + writing, the following servers are available:</para> + + <itemizedlist> + <listitem> + <para><emphasis>France</emphasis>: + :pserver:anoncvs@anoncvs.fr.FreeBSD.org:/home/ncvs + (For pserver mode, use <command>cvs login</command> and + enter the password <quote>anoncvs</quote> when prompted. + For ssh, no password is required.)</para> + </listitem> + <!-- + <listitem> + <para><emphasis>Japan</emphasis>: + :pserver:anoncvs@anoncvs.jp.FreeBSD.org:/home/ncvs + (Use <command>cvs login</command> and enter the password + <quote>anoncvs</quote> when prompted.)</para> + </listitem> + --> + <listitem> + <para><emphasis>Taiwan</emphasis>: + :pserver:anoncvs@anoncvs.tw.FreeBSD.org:/home/ncvs + (For pserver mode, use <command>cvs login</command> and + enter any password when prompted. For ssh, no password + is required.)</para> + + <programlisting>SSH2 HostKey: 1024 02:ed:1b:17:d6:97:2b:58:5e:5c:e2:da:3b:89:88:26 /etc/ssh/ssh_host_rsa_key.pub +SSH2 HostKey: 1024 e8:3b:29:7b:ca:9f:ac:e9:45:cb:c8:17:ae:9b:eb:55 /etc/ssh/ssh_host_dsa_key.pub</programlisting> + + </listitem> + <!-- + <listitem> + <para><emphasis>USA</emphasis>: + anoncvs@anoncvs1.FreeBSD.org:/home/ncvs (For ssh, use ssh + version 2 and no password is required.)</para> + + <programlisting>SSH2 HostKey: 2048 53:1f:15:a3:72:5c:43:f6:44:0e:6a:e9:bb:f8:01:62 /etc/ssh/ssh_host_dsa_key.pub</programlisting> - <para><xref linkend="cvs-tags"/> contains revision tags that users - might be interested - in. Again, none of these are valid for the Ports Collection - since the Ports Collection does not have multiple - branches of development.</para> + </listitem> + --> + </itemizedlist> - <para>When you specify a branch tag, you normally receive the - latest versions of the files on that line of development. If - you wish to receive some past version, you can do so by - specifying a date with the <option>-D date</option> flag. - See the &man.cvs.1; manual page for more details.</para> - </sect2> + <para>Since CVS allows one to <quote>check out</quote> virtually + any version of the &os; sources that ever existed (or, in some + cases, will exist), you need to be familiar with the revision + (<option>-r</option>) flag to &man.cvs.1; and what some of the + permissible values for it in the &os; Project repository + are.</para> + + <para>There are two kinds of tags, revision tags and branch + tags. A revision tag refers to a specific revision. Its + meaning stays the same from day to day. A branch tag, on the + other hand, refers to the latest revision on a given line of + development, at any given time. Because a branch tag does not + refer to a specific revision, it may mean something different + tomorrow than it means today.</para> + + <para><xref linkend="cvs-tags"/> contains revision tags that + users might be interested in. Again, none of these are valid + for the Ports Collection since the Ports Collection does not + have multiple branches of development.</para> + + <para>When you specify a branch tag, you normally receive the + latest versions of the files on that line of development. If + you wish to receive some past version, you can do so by + specifying a date with the <option>-D date</option> flag. See + the &man.cvs.1; manual page for more details.</para> + </sect2> - <sect2> - <title>Examples</title> + <sect2> + <title>Examples</title> - <para>While it really is recommended that you read the manual page - for &man.cvs.1; thoroughly before doing anything, here are some - quick examples which essentially show how to use Anonymous - CVS:</para> + <para>While it really is recommended that you read the manual + page for &man.cvs.1; thoroughly before doing anything, here + are some quick examples which essentially show how to use + Anonymous CVS:</para> - <example> - <title>Checking Out Something from -CURRENT (&man.ls.1;):</title> + <example> + <title>Checking Out Something from -CURRENT + (&man.ls.1;):</title> - <screen>&prompt.user; <userinput>setenv CVSROOT :pserver:anoncvs@anoncvs.tw.FreeBSD.org:/home/ncvs</userinput> + <screen>&prompt.user; <userinput>setenv CVSROOT :pserver:anoncvs@anoncvs.tw.FreeBSD.org:/home/ncvs</userinput> &prompt.user; <userinput>cvs login</userinput> <emphasis>At the prompt, enter any word for</emphasis> <quote>password</quote>. &prompt.user; <userinput>cvs co ls</userinput> - </screen> - </example> + </screen> + </example> - <example> - <title>Using SSH to Check Out the <filename>src/</filename> - Tree:</title> - <screen>&prompt.user; <userinput>cvs -d anoncvs@anoncvs1.FreeBSD.org:/home/ncvs co src</userinput> + <example> + <title>Using SSH to Check Out the <filename>src/</filename> + Tree:</title> + + <screen>&prompt.user; <userinput>cvs -d anoncvs@anoncvs1.FreeBSD.org:/home/ncvs co src</userinput> The authenticity of host 'anoncvs1.freebsd.org (216.87.78.137)' can't be established. DSA key fingerprint is 53:1f:15:a3:72:5c:43:f6:44:0e:6a:e9:bb:f8:01:62. Are you sure you want to continue connecting (yes/no)? <userinput>yes</userinput> Warning: Permanently added 'anoncvs1.freebsd.org' (DSA) to the list of known hosts.</screen> - </example> + </example> - <example> - <title>Checking Out the Version of &man.ls.1; in the 8-STABLE - Branch:</title> + <example> + <title>Checking Out the Version of &man.ls.1; in the 8-STABLE + Branch:</title> - <screen>&prompt.user; <userinput>setenv CVSROOT :pserver:anoncvs@anoncvs.tw.FreeBSD.org:/home/ncvs</userinput> + <screen>&prompt.user; <userinput>setenv CVSROOT :pserver:anoncvs@anoncvs.tw.FreeBSD.org:/home/ncvs</userinput> &prompt.user; <userinput>cvs login</userinput> <emphasis>At the prompt, enter any word for</emphasis> <quote>password</quote>. &prompt.user; <userinput>cvs co -rRELENG_8 ls</userinput> - </screen> - </example> + </screen> + </example> - <example> - <title>Creating a List of Changes (as Unified Diffs) to &man.ls.1;</title> + <example> + <title>Creating a List of Changes (as Unified Diffs) to + &man.ls.1;</title> - <screen>&prompt.user; <userinput>setenv CVSROOT :pserver:anoncvs@anoncvs.tw.FreeBSD.org:/home/ncvs</userinput> + <screen>&prompt.user; <userinput>setenv CVSROOT :pserver:anoncvs@anoncvs.tw.FreeBSD.org:/home/ncvs</userinput> &prompt.user; <userinput>cvs login</userinput> <emphasis>At the prompt, enter any word for</emphasis> <quote>password</quote>. &prompt.user; <userinput>cvs rdiff -u -rRELENG_8_0_0_RELEASE -rRELENG_8_1_0_RELEASE ls</userinput> - </screen> - </example> + </screen> + </example> - <example> - <title>Finding Out What Other Module Names Can Be Used:</title> + <example> + <title>Finding Out What Other Module Names Can Be + Used:</title> - <screen>&prompt.user; <userinput>setenv CVSROOT :pserver:anoncvs@anoncvs.tw.FreeBSD.org:/home/ncvs</userinput> + <screen>&prompt.user; <userinput>setenv CVSROOT :pserver:anoncvs@anoncvs.tw.FreeBSD.org:/home/ncvs</userinput> &prompt.user; <userinput>cvs login</userinput> <emphasis>At the prompt, enter any word for</emphasis> <quote>password</quote>. &prompt.user; <userinput>cvs co modules</userinput> &prompt.user; <userinput>more modules/modules</userinput> - </screen> - </example> - </sect2> - - <sect2> - <title>Other Resources</title> + </screen> + </example> + </sect2> - <para>The following additional resources may be helpful in learning - CVS:</para> + <sect2> + <title>Other Resources</title> - <itemizedlist> - <listitem> - <para><ulink - url="http://users.csc.calpoly.edu/~gfisher/classes/308/handouts/cvs-basics.html">CVS Tutorial</ulink> from California - Polytechnic State University.</para> - </listitem> + <para>The following additional resources may be helpful in + learning CVS:</para> - <listitem> - <para><ulink url="http://www.nongnu.org/cvs/">CVS Home</ulink>, - the CVS development and support community.</para> - </listitem> + <itemizedlist> + <listitem> + <para><ulink + url="http://users.csc.calpoly.edu/~gfisher/classes/308/handouts/cvs-basics.html">CVS + Tutorial</ulink> from California Polytechnic State + University.</para> + </listitem> - <listitem> - <para><ulink - url="http://www.FreeBSD.org/cgi/cvsweb.cgi">CVSweb</ulink> is - the &os; Project web interface for CVS.</para> - </listitem> - </itemizedlist> - </sect2> - </sect1> + <listitem> + <para><ulink url="http://www.nongnu.org/cvs/">CVS + Home</ulink>, the CVS development and support + community.</para> + </listitem> + <listitem> + <para><ulink + url="http://www.FreeBSD.org/cgi/cvsweb.cgi">CVSweb</ulink> + is the &os; Project web interface for CVS.</para> + </listitem> + </itemizedlist> + </sect2> + </sect1> <sect1 id="ctm"> <title>Using CTM</title> - <indexterm> - <primary>CTM</primary> - </indexterm> + <indexterm> + <primary>CTM</primary> + </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> - - <sect2> - <title>Why Should I Use <application>CTM</application>?</title> - - <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>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> - <title>What Do I Need to Use - <application>CTM</application>?</title> - - <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> - - <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> - - <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> - - <para><ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/"></ulink></para> - - <para>or see section <link + <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> + + <sect2> + <title>Why Should I Use <application>CTM</application>?</title> + + <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>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> + <title>What Do I Need to Use + <application>CTM</application>?</title> + + <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> + + <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> + + <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> + + <para><ulink + url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/"></ulink></para> + + <para>or see section <link linkend="mirrors-ctm">mirrors</link>.</para> - <para>FTP the relevant directory and fetch the - <filename>README</filename> file, starting from there.</para> - - <para>If you wish to get your deltas via email:</para> - - <para>Subscribe to one of the - <application>CTM</application> distribution lists. - &a.ctm-cvs-cur.name; supports the entire CVS tree. - &a.ctm-src-cur.name; supports the head of the development - branch. &a.ctm-src-7.name; supports the 7.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 - 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> - </note> - </sect2> - - <sect2> - <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>Since the trees are many tens of megabytes, you should - prefer to start from something already at hand. If you have a - -RELEASE CD, you can copy or extract an initial source from it. - This will save a significant transfer of data.</para> - - <para>You can recognize these <quote>starter</quote> deltas by the - <literal>X</literal> appended to the number - (<filename>src-cur.3210XEmpty.gz</filename> for instance). The - designation following the <literal>X</literal> corresponds to - the origin of your initial <quote>seed</quote>. - <filename>Empty</filename> is an empty directory. As a rule a - base transition from <literal>Empty</literal> is produced - every 100 deltas. By the way, they are large! 70 to 80 - Megabytes of <command>gzip</command>'d data is common for the - <filename>XEmpty</filename> deltas.</para> - - <para>Once you have picked a base delta to start from, you will also - need all deltas with higher numbers following it.</para> - </sect2> - - <sect2> - <title>Using <application>CTM</application> in Your Daily - Life</title> - - <para>To apply the deltas, simply say:</para> - - <screen>&prompt.root; <userinput>cd /where/ever/you/want/the/stuff</userinput> + <para>FTP the relevant directory and fetch the + <filename>README</filename> file, starting from there.</para> + + <para>If you wish to get your deltas via email:</para> + + <para>Subscribe to one of the + <application>CTM</application> distribution lists. + &a.ctm-cvs-cur.name; supports the entire CVS tree. + &a.ctm-src-cur.name; supports the head of the development + branch. &a.ctm-src-7.name; supports the 7.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 + 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> + </note> + </sect2> + + <sect2> + <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>Since the trees are many tens of megabytes, you should + prefer to start from something already at hand. If you have a + -RELEASE CD, you can copy or extract an initial source from + it. This will save a significant transfer of data.</para> + + <para>You can recognize these <quote>starter</quote> deltas by + the <literal>X</literal> appended to the number + (<filename>src-cur.3210XEmpty.gz</filename> for instance). + The designation following the <literal>X</literal> corresponds + to the origin of your initial <quote>seed</quote>. + <filename>Empty</filename> is an empty directory. As a rule a + base transition from <literal>Empty</literal> is produced + every 100 deltas. By the way, they are large! 70 to 80 + Megabytes of <command>gzip</command>'d data is common for the + <filename>XEmpty</filename> deltas.</para> + + <para>Once you have picked a base delta to start from, you will + also need all deltas with higher numbers following it.</para> + </sect2> + + <sect2> + <title>Using <application>CTM</application> in Your Daily + Life</title> + + <para>To apply the deltas, simply say:</para> + + <screen>&prompt.root; <userinput>cd /where/ever/you/want/the/stuff</userinput> &prompt.root; <userinput>ctm -v -v /where/you/store/your/deltas/src-xxx.*</userinput></screen> - <para><application>CTM</application> understands deltas which have - been put through <command>gzip</command>, so you do not need to - <command>gunzip</command> them first, this saves disk space.</para> - - <para>Unless it feels very secure about the entire process, - <application>CTM</application> will not touch your tree. To - verify a delta you can also use the <option>-c</option> flag and - <application>CTM</application> will not actually touch your - tree; it will merely verify the integrity of the delta and see - if it would apply cleanly to your current tree.</para> - - <para>There are other options to <application>CTM</application> - as well, see the manual pages or look in the sources for more - information.</para> - - <para>That is really all there is to it. Every time you get a new - delta, just run it through <application>CTM</application> to - keep your sources up to date.</para> - - <para>Do not 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 - <command>fdwrite</command> to make a copy.</para> - </sect2> - - <sect2> - <title>Keeping Your Local Changes</title> - - <para>As a developer one would like to experiment with and change - files in the source tree. <application>CTM</application> - supports local modifications in a limited way: before checking - for the presence of a file <filename>foo</filename>, it first - looks for <filename>foo.ctm</filename>. If this file exists, - <application>CTM</application> will operate on it instead of - <filename>foo</filename>.</para> - - <para>This behavior gives us a simple way to maintain local - changes: simply copy the files you plan to modify to the - corresponding file names with a <filename>.ctm</filename> - suffix. Then you can freely hack the code, while <application>CTM</application> keeps the - <filename>.ctm</filename> file up-to-date.</para> - </sect2> - - <sect2> - <title>Other Interesting <application>CTM</application> Options</title> - - <sect3> - <title>Finding Out Exactly What Would Be Touched by an - Update</title> - - <para>You can determine the list of changes that - <application>CTM</application> will make on your source - repository using the <option>-l</option> option to - <application>CTM</application>.</para> - - <para>This is useful if you would like to keep logs of the - changes, pre- or post- process the modified files in any - manner, or just are feeling a tad paranoid.</para> - </sect3> - - <sect3> - <title>Making Backups Before Updating</title> - - <para>Sometimes you may want to backup all the files that would - be changed by a <application>CTM</application> update.</para> - - <para>Specifying the <option>-B backup-file</option> option - causes <application>CTM</application> to backup all files that - would be touched by a given <application>CTM</application> - delta to <filename>backup-file</filename>.</para> - </sect3> - - <sect3> - <title>Restricting the Files Touched by an Update</title> - - <para>Sometimes you would be interested in restricting the scope - of a given <application>CTM</application> update, or may be - interested in extracting just a few files from a sequence of - deltas.</para> - - <para>You can control the list of files that - <application>CTM</application> would operate on by specifying - filtering regular expressions using the <option>-e</option> - and <option>-x</option> options.</para> - - <para>For example, to extract an up-to-date copy of - <filename>lib/libc/Makefile</filename> from your collection of - saved <application>CTM</application> deltas, run the commands:</para> - - <screen>&prompt.root; <userinput>cd /where/ever/you/want/to/extract/it/</userinput> -&prompt.root; <userinput>ctm -e '^lib/libc/Makefile' ~ctm/src-xxx.*</userinput></screen> + <para><application>CTM</application> understands deltas which + have been put through <command>gzip</command>, so you do not + need to <command>gunzip</command> them first, this saves disk + space.</para> + + <para>Unless it feels very secure about the entire process, + <application>CTM</application> will not touch your tree. To + verify a delta you can also use the <option>-c</option> flag + and <application>CTM</application> will not actually touch + your tree; it will merely verify the integrity of the delta + and see if it would apply cleanly to your current tree.</para> + + <para>There are other options to <application>CTM</application> + as well, see the manual pages or look in the sources for more + information.</para> + + <para>That is really all there is to it. Every time you get a + new delta, just run it through <application>CTM</application> + to keep your sources up to date.</para> + + <para>Do not 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 <command>fdwrite</command> to make a + copy.</para> + </sect2> - <para>For every file specified in a - <application>CTM</application> delta, the <option>-e</option> - and <option>-x</option> options are applied in the order given - on the command line. The file is processed by - <application>CTM</application> only if it is marked as - eligible after all the <option>-e</option> and - <option>-x</option> options are applied to it.</para> - </sect3> - </sect2> + <sect2> + <title>Keeping Your Local Changes</title> + + <para>As a developer one would like to experiment with and + change files in the source tree. + <application>CTM</application> supports local modifications in + a limited way: before checking for the presence of a file + <filename>foo</filename>, it first looks for + <filename>foo.ctm</filename>. If this file exists, + <application>CTM</application> will operate on it instead of + <filename>foo</filename>.</para> + + <para>This behavior gives us a simple way to maintain local + changes: simply copy the files you plan to modify to the + corresponding file names with a <filename>.ctm</filename> + suffix. Then you can freely hack the code, while + <application>CTM</application> keeps the + <filename>.ctm</filename> file up-to-date.</para> + </sect2> - <sect2> - <title>Future Plans for <application>CTM</application></title> + <sect2> + <title>Other Interesting <application>CTM</application> + Options</title> - <para>Tons of them:</para> + <sect3> + <title>Finding Out Exactly What Would Be Touched by an + Update</title> - <itemizedlist> - <listitem> - <para>Use some kind of authentication into the <application>CTM</application> system, so - as to allow detection of spoofed <application>CTM</application> updates.</para> - </listitem> + <para>You can determine the list of changes that + <application>CTM</application> will make on your source + repository using the <option>-l</option> option to + <application>CTM</application>.</para> - <listitem> - <para>Clean up the options to <application>CTM</application>, - they became confusing and counter intuitive.</para> - </listitem> - </itemizedlist> - </sect2> + <para>This is useful if you would like to keep logs of the + changes, pre- or post- process the modified files in any + manner, or just are feeling a tad paranoid.</para> + </sect3> - <sect2> - <title>Miscellaneous Stuff</title> + <sect3> + <title>Making Backups Before Updating</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> + <para>Sometimes you may want to backup all the files that + would be changed by a <application>CTM</application> + update.</para> - <sect2 id="mirrors-ctm"> - <title>CTM Mirrors</title> + <para>Specifying the <option>-B backup-file</option> option + causes <application>CTM</application> to backup all files + that would be touched by a given + <application>CTM</application> delta to + <filename>backup-file</filename>.</para> + </sect3> - <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> + <sect3> + <title>Restricting the Files Touched by an Update</title> - <para>In case of problems, please contact the &a.ctm-users.name; - mailing list.</para> + <para>Sometimes you would be interested in restricting the + scope of a given <application>CTM</application> update, or + may be interested in extracting just a few files from a + sequence of deltas.</para> - <variablelist> - <varlistentry> - <term>California, Bay Area, official source</term> + <para>You can control the list of files that + <application>CTM</application> would operate on by + specifying filtering regular expressions using the + <option>-e</option> and <option>-x</option> options.</para> + + <para>For example, to extract an up-to-date copy of + <filename>lib/libc/Makefile</filename> from your collection + of saved <application>CTM</application> deltas, run the + commands:</para> + + <screen>&prompt.root; <userinput>cd /where/ever/you/want/to/extract/it/</userinput> +&prompt.root; <userinput>ctm -e '^lib/libc/Makefile' ~ctm/src-xxx.*</userinput></screen> + <para>For every file specified in a + <application>CTM</application> delta, the + <option>-e</option> and <option>-x</option> options are + applied in the order given on the command line. The file is + processed by <application>CTM</application> only if it is + marked as eligible after all the <option>-e</option> and + <option>-x</option> options are applied to it.</para> + </sect3> + </sect2> + + <sect2> + <title>Future Plans for <application>CTM</application></title> + + <para>Tons of them:</para> + + <itemizedlist> <listitem> - <itemizedlist> - <listitem> - <para><ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para> - </listitem> - </itemizedlist> + <para>Use some kind of authentication into the + <application>CTM</application> system, so as to allow + detection of spoofed <application>CTM</application> + updates.</para> </listitem> - </varlistentry> - - <varlistentry> - <term>South Africa, backup server for old deltas</term> <listitem> - <itemizedlist> - <listitem> - <para><ulink url="ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/"></ulink></para> - </listitem> - </itemizedlist> + <para>Clean up the options to + <application>CTM</application>, they became confusing and + counter intuitive.</para> </listitem> - </varlistentry> + </itemizedlist> + </sect2> - <varlistentry> - <term>Taiwan/R.O.C.</term> + <sect2> + <title>Miscellaneous Stuff</title> - <listitem> - <itemizedlist> - <listitem> - <para><ulink url="ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para> - </listitem> + <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> - <listitem> - <para><ulink url="ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para> - </listitem> + <sect2 id="mirrors-ctm"> + <title>CTM Mirrors</title> - <listitem> - <para><ulink url="ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para> - </listitem> - </itemizedlist> - </listitem> - </varlistentry> - </variablelist> + <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><ulink + url="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry> + <term>South Africa, backup server for old deltas</term> + + <listitem> + <itemizedlist> + <listitem> + <para><ulink + url="ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/"></ulink></para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> - <para>If you did not find a mirror near to you or the mirror is - incomplete, try to use a search engine such as - <ulink url="http://www.alltheweb.com/">alltheweb</ulink>.</para> - </sect2></sect1> + <varlistentry> + <term>Taiwan/R.O.C.</term> + + <listitem> + <itemizedlist> + <listitem> + <para><ulink + url="ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para> + </listitem> + + <listitem> + <para><ulink + url="ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para> + </listitem> + + <listitem> + <para><ulink + url="ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></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 <ulink + url="http://www.alltheweb.com/">alltheweb</ulink>.</para> + </sect2> + </sect1> <sect1 id="cvsup"> <title>Using CVSup</title> @@ -903,88 +946,94 @@ Warning: Permanently added 'anoncvs1.freebsd.org' (DSA) to the list of known hos <para><application>CVSup</application> is a software package for distributing and updating source trees from a master CVS repository on a remote server host. The &os; sources are - maintained in a CVS repository on a central development machine - in California. With <application>CVSup</application>, &os; - users can easily keep their own source trees up to date.</para> + maintained in a CVS repository on a central development + machine in California. With <application>CVSup</application>, + &os; users can easily keep their own source trees up to + date.</para> <para><application>CVSup</application> uses the so-called <emphasis>pull</emphasis> model of updating. Under the pull - model, each client asks the server for updates, if and when they - are wanted. The server waits passively for update requests from - its clients. Thus all updates are instigated by the client. - The server never sends unsolicited updates. Users must either - run the <application>CVSup</application> client manually to get - an update, or they must set up a <command>cron</command> job to - run it automatically on a regular basis.</para> - - <para>The term <application>CVSup</application>, capitalized just - so, refers to the entire software package. Its main components - are the client <command>cvsup</command> which runs on each - user's machine, and the server <command>cvsupd</command> which - runs at each of the &os; mirror sites.</para> + model, each client asks the server for updates, if and when + they are wanted. The server waits passively for update + requests from its clients. Thus all updates are instigated by + the client. The server never sends unsolicited updates. + Users must either run the <application>CVSup</application> + client manually to get an update, or they must set up a + <command>cron</command> job to run it automatically on a + regular basis.</para> + + <para>The term <application>CVSup</application>, capitalized + just so, refers to the entire software package. Its main + components are the client <command>cvsup</command> which runs + on each user's machine, and the server + <command>cvsupd</command> which runs at each of the &os; + mirror sites.</para> <para>As you read the &os; documentation and mailing lists, you may see references to <application>sup</application>. <application>Sup</application> was the predecessor of <application>CVSup</application>, and it served a similar purpose. <application>CVSup</application> is used much in the - same way as sup and, in fact, uses configuration files which are - backward-compatible with <command>sup</command>'s. + same way as sup and, in fact, uses configuration files which + are backward-compatible with <command>sup</command>'s. <application>Sup</application> is no longer used in the &os; - project, because <application>CVSup</application> is both faster - and more flexible.</para> + project, because <application>CVSup</application> is both + faster and more flexible.</para> <note> - <para>The <application>csup</application> utility is a rewrite of the - <application>CVSup</application> software in C. Its biggest - advantage is, that it is faster and does not depend on the - Modula-3 language, thus you do not need to install it as a - requirement. Moreover - you can use it out-of-the-box, since it is included in the base - system. - If you decided to use - <application>csup</application>, just skip the steps on the - installation of <application>CVSup</application> and - substitute the references of <application>CVSup</application> with - <application>csup</application> while following the remainder of - this article.</para> + <para>The <application>csup</application> utility is a rewrite + of the <application>CVSup</application> software in C. Its + biggest advantage is, that it is faster and does not depend + on the Modula-3 language, thus you do not need to install it + as a requirement. Moreover you can use it out-of-the-box, + since it is included in the base system. If you decided to + use <application>csup</application>, just skip the steps on + the installation of <application>CVSup</application> and + substitute the references of + <application>CVSup</application> with + <application>csup</application> while following the + remainder of this article.</para> </note> </sect2> <sect2 id="cvsup-install"> <title>Installation</title> - <para>The easiest way to install <application>CVSup</application> - is to use the precompiled <filename role="package">net/cvsup</filename> package - from the &os; <link linkend="ports">packages collection</link>. - If you prefer to build <application>CVSup</application> from - source, you can use the <filename role="package">net/cvsup</filename> - port instead. But be forewarned: the - <filename role="package">net/cvsup</filename> port depends on the Modula-3 - system, which takes a substantial amount of time and + <para>The easiest way to install + <application>CVSup</application> is to use the precompiled + <filename role="package">net/cvsup</filename> package from the + &os; <link linkend="ports">packages collection</link>. If you + prefer to build <application>CVSup</application> from source, + you can use the <filename role="package">net/cvsup</filename> + port instead. But be forewarned: the <filename + role="package">net/cvsup</filename> port depends on the + Modula-3 system, which takes a substantial amount of time and disk space to download and build.</para> - <note> - <para>If you are going to be using - <application>CVSup</application> on a machine which will not have - <application>&xorg;</application> installed, such as a server, be - sure to use the port which does not include the + <note> + <para>If you are going to be using + <application>CVSup</application> on a machine which will not + have <application>&xorg;</application> installed, such as a + server, be sure to use the port which does not include the <application>CVSup</application> <acronym>GUI</acronym>, - <filename role="package">net/cvsup-without-gui</filename>.</para> - </note> + <filename + role="package">net/cvsup-without-gui</filename>.</para> + </note> </sect2> <sect2 id="cvsup-config"> <title>CVSup Configuration</title> <para><application>CVSup</application>'s operation is controlled - by a configuration file called the <filename>supfile</filename>. - There are some sample <filename>supfiles</filename> in the - directory <ulink type="html" + by a configuration file called the + <filename>supfile</filename>. There are some sample + <filename>supfiles</filename> in the directory <ulink + type="html" url="file://localhost/usr/share/examples/cvsup/"><filename>/usr/share/examples/cvsup/</filename></ulink>.</para> <para>The information in a <filename>supfile</filename> answers - the following questions for <application>CVSup</application>:</para> + the following questions for + <application>CVSup</application>:</para> <itemizedlist> <listitem> @@ -993,13 +1042,13 @@ Warning: Permanently added 'anoncvs1.freebsd.org' (DSA) to the list of known hos </listitem> <listitem> - <para><link linkend="cvsup-config-vers">Which versions of them - do you want?</link></para> + <para><link linkend="cvsup-config-vers">Which versions of + them do you want?</link></para> </listitem> <listitem> - <para><link linkend="cvsup-config-where">Where do you want to - get them from?</link></para> + <para><link linkend="cvsup-config-where">Where do you want + to get them from?</link></para> </listitem> <listitem> @@ -1008,15 +1057,15 @@ Warning: Permanently added 'anoncvs1.freebsd.org' (DSA) to the list of known hos </listitem> <listitem> - <para><link linkend="cvsup-config-status">Where do you want to - put your status files?</link></para> + <para><link linkend="cvsup-config-status">Where do you want + to put your status files?</link></para> </listitem> </itemizedlist> <para>In the following sections, we will construct a typical <filename>supfile</filename> by answering each of these - questions in turn. First, we describe the overall structure of - a <filename>supfile</filename>.</para> + questions in turn. First, we describe the overall structure + of a <filename>supfile</filename>.</para> <para>A <filename>supfile</filename> is a text file. Comments begin with <literal>#</literal> and extend to the end of the @@ -1025,95 +1074,95 @@ Warning: Permanently added 'anoncvs1.freebsd.org' (DSA) to the list of known hos <para>Each remaining line describes a set of files that the user wishes to receive. The line begins with the name of a - <quote>collection</quote>, a logical grouping of files defined by - the server. The name of the collection tells the server which - files you want. After the collection name come zero or more - fields, separated by white space. These fields answer the - questions listed above. There are two types of fields: flag - fields and value fields. A flag field consists of a keyword - standing alone, e.g., <literal>delete</literal> or + <quote>collection</quote>, a logical grouping of files defined + by the server. The name of the collection tells the server + which files you want. After the collection name come zero or + more fields, separated by white space. These fields answer + the questions listed above. There are two types of fields: + flag fields and value fields. A flag field consists of a + keyword standing alone, e.g., <literal>delete</literal> or <literal>compress</literal>. A value field also begins with a keyword, but the keyword is followed without intervening white space by <literal>=</literal> and a second word. For example, <literal>release=cvs</literal> is a value field.</para> - <para>A <filename>supfile</filename> typically specifies more than - one collection to receive. One way to structure a + <para>A <filename>supfile</filename> typically specifies more + than one collection to receive. One way to structure a <filename>supfile</filename> is to specify all of the relevant fields explicitly for each collection. However, that tends to make the <filename>supfile</filename> lines quite long, and it - is inconvenient because most fields are the same for all of the - collections in a <filename>supfile</filename>. - <application>CVSup</application> provides a defaulting mechanism - to avoid these problems. Lines beginning with the special - pseudo-collection name <literal>*default</literal> can be used - to set flags and values which will be used as defaults for the - subsequent collections in the <filename>supfile</filename>. A - default value can be overridden for an individual collection, by - specifying a different value with the collection itself. - Defaults can also be changed or augmented in mid-supfile by - additional <literal>*default</literal> lines.</para> + is inconvenient because most fields are the same for all of + the collections in a <filename>supfile</filename>. + <application>CVSup</application> provides a defaulting + mechanism to avoid these problems. Lines beginning with the + special pseudo-collection name <literal>*default</literal> can + be used to set flags and values which will be used as defaults + for the subsequent collections in the + <filename>supfile</filename>. A default value can be + overridden for an individual collection, by specifying a + different value with the collection itself. Defaults can also + be changed or augmented in mid-supfile by additional + <literal>*default</literal> lines.</para> <para>With this background, we will now proceed to construct a - <filename>supfile</filename> for receiving and updating the main - source tree of <link - linkend="current">&os;-CURRENT</link>.</para> + <filename>supfile</filename> for receiving and updating the + main source tree of + <link linkend="current">&os;-CURRENT</link>.</para> <itemizedlist> <listitem> - <para><anchor id="cvsup-config-files"/>Which files do you want - to receive?</para> - - <para>The files available via <application>CVSup</application> - are organized into named groups called - <quote>collections</quote>. The collections that are - available are described in the <link - linkend="cvsup-collec">following section</link>. In this - example, we - wish to receive the entire main source tree for the &os; - system. There is a single large collection - <literal>src-all</literal> which will give us all of that. - As a first step toward constructing our - <filename>supfile</filename>, we - simply list the collections, one per line (in this case, - only one line):</para> + <para><anchor id="cvsup-config-files"/>Which files do you + want to receive?</para> + + <para>The files available via + <application>CVSup</application> are organized into named + groups called <quote>collections</quote>. The collections + that are available are described in the + <link linkend="cvsup-collec">following section</link>. In + this example, we wish to receive the entire main source + tree for the &os; system. There is a single large + collection <literal>src-all</literal> which will give us + all of that. As a first step toward constructing our + <filename>supfile</filename>, we simply list the + collections, one per line (in this case, only one + line):</para> <programlisting>src-all</programlisting> </listitem> <listitem> - <para><anchor id="cvsup-config-vers"/>Which version(s) of them - do you want?</para> + <para><anchor id="cvsup-config-vers"/>Which version(s) of + them do you want?</para> <para>With <application>CVSup</application>, you can receive virtually any version of the sources that ever existed. That is possible because the - <application>cvsupd</application> server works directly from - the CVS repository, which contains all of the versions. You - specify which one of them you want using the - <literal>tag=</literal> and <option>date=</option> value - fields.</para> + <application>cvsupd</application> server works directly + from the CVS repository, which contains all of the + versions. You specify which one of them you want using + the <literal>tag=</literal> and <option>date=</option> + value fields.</para> <warning> - <para>Be very careful to specify any <literal>tag=</literal> - fields correctly. Some tags are valid only for certain - collections of files. If you specify an incorrect or - misspelled tag, <application>CVSup</application> - will delete files which you probably - do not want deleted. In particular, use <emphasis>only - </emphasis> <literal>tag=.</literal> for the - <literal>ports-*</literal> collections.</para> + <para>Be very careful to specify any + <literal>tag=</literal> fields correctly. Some tags are + valid only for certain collections of files. If you + specify an incorrect or misspelled tag, + <application>CVSup</application> will delete files which + you probably do not want deleted. In particular, use + <emphasis>only </emphasis> <literal>tag=.</literal> for + the <literal>ports-*</literal> collections.</para> </warning> <para>The <literal>tag=</literal> field names a symbolic tag in the repository. There are two kinds of tags, revision tags and branch tags. A revision tag refers to a specific revision. Its meaning stays the same from day to day. A - branch tag, on the other hand, refers to the latest revision - on a given line of development, at any given time. Because - a branch tag does not refer to a specific revision, it may - mean something different tomorrow than it means - today.</para> + branch tag, on the other hand, refers to the latest + revision on a given line of development, at any given + time. Because a branch tag does not refer to a specific + revision, it may mean something different tomorrow than it + means today.</para> <para><xref linkend="cvs-tags"/> contains branch tags that users might be interested in. When specifying a tag in @@ -1125,21 +1174,21 @@ Warning: Permanently added 'anoncvs1.freebsd.org' (DSA) to the list of known hos relevant for the Ports Collection.</para> <warning> - <para>Be very careful to type the tag name exactly as shown. - <application>CVSup</application> cannot distinguish - between valid and invalid tags. If you misspell the tag, - <application>CVSup</application> will behave as though you - had specified a valid tag which happens to refer to no - files at all. It will delete your existing sources in - that case.</para> + <para>Be very careful to type the tag name exactly as + shown. <application>CVSup</application> cannot + distinguish between valid and invalid tags. If you + misspell the tag, <application>CVSup</application> will + behave as though you had specified a valid tag which + happens to refer to no files at all. It will delete + your existing sources in that case.</para> </warning> - <para>When you specify a branch tag, you normally receive the - latest versions of the files on that line of development. - If you wish to receive some past version, you can do so by - specifying a date with the <option>date=</option> value - field. The &man.cvsup.1; manual page explains how to do - that.</para> + <para>When you specify a branch tag, you normally receive + the latest versions of the files on that line of + development. If you wish to receive some past version, + you can do so by specifying a date with the + <option>date=</option> value field. The &man.cvsup.1; + manual page explains how to do that.</para> <para>For our example, we wish to receive &os;-CURRENT. We add this line at the beginning of our @@ -1147,49 +1196,51 @@ Warning: Permanently added 'anoncvs1.freebsd.org' (DSA) to the list of known hos <programlisting>*default tag=.</programlisting> - <para>There is an important special case that comes into play - if you specify neither a <literal>tag=</literal> field nor a - <literal>date=</literal> field. In that case, you receive - the actual RCS files directly from the server's CVS - repository, rather than receiving a particular version. - Developers generally prefer this mode of operation. By - maintaining a copy of the repository itself on their - systems, they gain the ability to browse the revision - histories and examine past versions of files. This gain is - achieved at a large cost in terms of disk space, - however.</para> + <para>There is an important special case that comes into + play if you specify neither a <literal>tag=</literal> + field nor a <literal>date=</literal> field. In that case, + you receive the actual RCS files directly from the + server's CVS repository, rather than receiving a + particular version. Developers generally prefer this mode + of operation. By maintaining a copy of the repository + itself on their systems, they gain the ability to browse + the revision histories and examine past versions of files. + This gain is achieved at a large cost in terms of disk + space, however.</para> </listitem> <listitem> - <para><anchor id="cvsup-config-where"/>Where do you want to get - them from?</para> + <para><anchor id="cvsup-config-where"/>Where do you want to + get them from?</para> <para>We use the <literal>host=</literal> field to tell <command>cvsup</command> where to obtain its updates. Any - of the <link linkend="cvsup-mirrors">CVSup mirror - sites</link> will do, though you should try to select one - that is close to you in cyberspace. In this example we will - use a fictional &os; distribution site, + of the + <link linkend="cvsup-mirrors">CVSup mirror sites</link> + will do, though you should try to select one that is close + to you in cyberspace. In this example we will use a + fictional &os; distribution site, <hostid role="fqdn">cvsup99.FreeBSD.org</hostid>:</para> <programlisting>*default host=cvsup99.FreeBSD.org</programlisting> <para>You will need to change the host to one that actually exists before running <application>CVSup</application>. - On any particular run of - <command>cvsup</command>, you can override the host setting - on the command line, with <option>-h + On any particular run of <command>cvsup</command>, you can + override the host setting on the command line, with + <option>-h <replaceable>hostname</replaceable></option>.</para> </listitem> <listitem> - <para><anchor id="cvsup-config-dest"/>Where do you want to put - them on your own machine?</para> + <para><anchor id="cvsup-config-dest"/>Where do you want to + put them on your own machine?</para> <para>The <literal>prefix=</literal> field tells - <command>cvsup</command> where to put the files it receives. - In this example, we will put the source files directly into - our main source tree, <filename>/usr/src</filename>. The + <command>cvsup</command> where to put the files it + receives. In this example, we will put the source files + directly into our main source tree, + <filename>/usr/src</filename>. The <filename>src</filename> directory is already implicit in the collections we have chosen to receive, so this is the correct specification:</para> @@ -1202,19 +1253,19 @@ Warning: Permanently added 'anoncvs1.freebsd.org' (DSA) to the list of known hos <command>cvsup</command> maintain its status files?</para> <para>The <application>CVSup</application> client maintains - certain status files in what - is called the <quote>base</quote> directory. These files - help <application>CVSup</application> to work more - efficiently, by keeping track of which updates you have - already received. We will use the standard base directory, + certain status files in what is called the + <quote>base</quote> directory. These files help + <application>CVSup</application> to work more efficiently, + by keeping track of which updates you have already + received. We will use the standard base directory, <filename>/var/db</filename>:</para> <programlisting>*default base=/var/db</programlisting> - <para>If your base directory does not already exist, now would - be a good time to create it. The <command>cvsup</command> - client will refuse to run if the base directory does not - exist.</para> + <para>If your base directory does not already exist, now + would be a good time to create it. The + <command>cvsup</command> client will refuse to run if the + base directory does not exist.</para> </listitem> <listitem> @@ -1227,38 +1278,38 @@ Warning: Permanently added 'anoncvs1.freebsd.org' (DSA) to the list of known hos <programlisting>*default release=cvs delete use-rel-suffix compress</programlisting> - <para><literal>release=cvs</literal> indicates that the server - should get its information out of the main &os; CVS + <para><literal>release=cvs</literal> indicates that the + server should get its information out of the main &os; CVS repository. This is virtually always the case, but there are other possibilities which are beyond the scope of this discussion.</para> <para><literal>delete</literal> gives - <application>CVSup</application> permission to delete files. - You should always specify this, so that + <application>CVSup</application> permission to delete + files. You should always specify this, so that <application>CVSup</application> can keep your source tree fully up-to-date. <application>CVSup</application> is careful to delete only those files for which it is responsible. Any extra files you happen to have will be left strictly alone.</para> - <para><literal>use-rel-suffix</literal> is ... arcane. If you - really want to know about it, see the &man.cvsup.1; manual - page. Otherwise, just specify it and do not worry about - it.</para> + <para><literal>use-rel-suffix</literal> is ... arcane. If + you really want to know about it, see the &man.cvsup.1; + manual page. Otherwise, just specify it and do not worry + about it.</para> <para><literal>compress</literal> enables the use of gzip-style compression on the communication channel. If - your network link is T1 speed or faster, you probably should - not use compression. Otherwise, it helps + your network link is T1 speed or faster, you probably + should not use compression. Otherwise, it helps substantially.</para> </listitem> <listitem> <para>Putting it all together:</para> - <para>Here is the entire <filename>supfile</filename> for our - example:</para> + <para>Here is the entire <filename>supfile</filename> for + our example:</para> <programlisting>*default tag=. *default host=cvsup99.FreeBSD.org @@ -1269,52 +1320,60 @@ Warning: Permanently added 'anoncvs1.freebsd.org' (DSA) to the list of known hos src-all</programlisting> </listitem> </itemizedlist> + <sect3 id="cvsup-refuse-file"> - <title>The <filename>refuse</filename> File</title> - - <para>As mentioned above, <application>CVSup</application> uses - a <emphasis>pull method</emphasis>. Basically, this means that - you connect to the <application>CVSup</application> server, and - it says, <quote>Here is what you can download from - me...</quote>, and your client responds <quote>OK, I will take - this, this, this, and this.</quote> In the default - configuration, the <application>CVSup</application> client will - take every file associated with the collection and tag you - chose in the configuration file. However, this is not always - what you want, especially if you are synching the <filename>doc</filename>, <filename>ports</filename>, or - <filename>www</filename> trees — most people cannot read four or five - languages, and therefore they do not need to download the - language-specific files. If you are - <application>CVSup</application>ing the Ports Collection, you - can get around this by specifying each collection individually - (e.g., <emphasis>ports-astrology</emphasis>, - <emphasis>ports-biology</emphasis>, etc instead of simply - saying <emphasis>ports-all</emphasis>). However, since the <filename>doc</filename> - and <filename>www</filename> trees do not have language-specific collections, you - must use one of <application>CVSup</application>'s many nifty - features: the <filename>refuse</filename> file.</para> - - <para>The <filename>refuse</filename> file essentially tells - <application>CVSup</application> that it should not take every - single file from a collection; in other words, it tells the - client to <emphasis>refuse</emphasis> certain files from the - server. The <filename>refuse</filename> file can be found (or, if you do not yet - have one, should be placed) in - <filename><replaceable>base</replaceable>/sup/</filename>. - <replaceable>base</replaceable> is defined in your <filename>supfile</filename>; - our defined <replaceable>base</replaceable> is - <filename>/var/db</filename>, - which means that by default the <filename>refuse</filename> file is - <filename>/var/db/sup/refuse</filename>.</para> - - <para>The <filename>refuse</filename> file has a very simple format; it simply - contains the names of files or directories that you do not wish - to download. For example, if you cannot speak any languages other - than English and some German, and you do not feel the need to read - the German translation of documentation, you can put the following in your - <filename>refuse</filename> file:</para> - - <screen>doc/bn_* + <title>The <filename>refuse</filename> File</title> + + <para>As mentioned above, <application>CVSup</application> + uses a <emphasis>pull method</emphasis>. Basically, this + means that you connect to the + <application>CVSup</application> server, and it says, + <quote>Here is what you can download from me...</quote>, and + your client responds + <quote>OK, I will take this, this, this, and this.</quote> + In the default configuration, the + <application>CVSup</application> client will take every file + associated with the collection and tag you chose in the + configuration file. However, this is not always what you + want, especially if you are synching the + <filename>doc</filename>, <filename>ports</filename>, or + <filename>www</filename> trees — most people cannot + read four or five languages, and therefore they do not need + to download the language-specific files. If you are + <application>CVSup</application>ing the Ports Collection, + you can get around this by specifying each collection + individually (e.g., <emphasis>ports-astrology</emphasis>, + <emphasis>ports-biology</emphasis>, etc instead of simply + saying <emphasis>ports-all</emphasis>). However, since the + <filename>doc</filename> and <filename>www</filename> trees + do not have language-specific collections, you must use one + of <application>CVSup</application>'s many nifty features: + the <filename>refuse</filename> file.</para> + + <para>The <filename>refuse</filename> file essentially tells + <application>CVSup</application> that it should not take + every single file from a collection; in other words, it + tells the client to <emphasis>refuse</emphasis> certain + files from the server. The <filename>refuse</filename> file + can be found (or, if you do not yet have one, should be + placed) in + <filename><replaceable>base</replaceable>/sup/</filename>. + <replaceable>base</replaceable> is defined in your + <filename>supfile</filename>; our defined + <replaceable>base</replaceable> is + <filename>/var/db</filename>, which means that by default + the <filename>refuse</filename> file is + <filename>/var/db/sup/refuse</filename>.</para> + + <para>The <filename>refuse</filename> file has a very simple + format; it simply contains the names of files or directories + that you do not wish to download. For example, if you + cannot speak any languages other than English and some + German, and you do not feel the need to read the German + translation of documentation, you can put the following in + your <filename>refuse</filename> file:</para> + + <screen>doc/bn_* doc/da_* doc/de_* doc/el_* @@ -1333,18 +1392,18 @@ doc/sr_* doc/tr_* doc/zh_*</screen> - <para>and so forth for the other languages (you can find the - full list by browsing the <ulink - url="http://www.FreeBSD.org/cgi/cvsweb.cgi/">&os; - CVS repository</ulink>).</para> - - <para>With this very useful feature, those users who are on - slow links or pay by the minute for their Internet connection - will be able to save valuable time as they will no longer need - to download files that they will never use. For more - information on <filename>refuse</filename> files and other neat - features of <application>CVSup</application>, please view its - manual page.</para> + <para>and so forth for the other languages (you can find the + full list by browsing the + <ulink url="http://www.FreeBSD.org/cgi/cvsweb.cgi/">&os; CVS + repository</ulink>).</para> + + <para>With this very useful feature, those users who are on + slow links or pay by the minute for their Internet + connection will be able to save valuable time as they will + no longer need to download files that they will never use. + For more information on <filename>refuse</filename> files + and other neat features of <application>CVSup</application>, + please view its manual page.</para> </sect3> </sect2> @@ -1356,23 +1415,24 @@ doc/zh_*</screen> <screen>&prompt.root; <userinput>cvsup <replaceable>supfile</replaceable></userinput></screen> - <para>where <filename><replaceable>supfile</replaceable></filename> - is of course the name of the <filename>supfile</filename> you have just created. - Assuming you are running under X11, <command>cvsup</command> - will display a GUI window with some buttons to do the usual - things. Press the <guibutton>go</guibutton> button, and watch it - run.</para> + <para>where + <filename><replaceable>supfile</replaceable></filename> is of + course the name of the <filename>supfile</filename> you have + just created. Assuming you are running under X11, + <command>cvsup</command> will display a GUI window with some + buttons to do the usual things. Press the + <guibutton>go</guibutton> button, and watch it run.</para> <para>Since you are updating your actual <filename>/usr/src</filename> tree in this example, you will need to run the program as <username>root</username> so that - <command>cvsup</command> has the permissions it needs to update - your files. Having just created your configuration file, and - having never used this program before, that might - understandably make you nervous. There is an easy way to do a - trial run without touching your precious files. Just create an - empty directory somewhere convenient, and name it as an extra - argument on the command line:</para> + <command>cvsup</command> has the permissions it needs to + update your files. Having just created your configuration + file, and having never used this program before, that might + understandably make you nervous. There is an easy way to do a + trial run without touching your precious files. Just create + an empty directory somewhere convenient, and name it as an + extra argument on the command line:</para> <screen>&prompt.root; <userinput>mkdir /var/tmp/dest</userinput> &prompt.root; <userinput>cvsup supfile /var/tmp/dest</userinput></screen> @@ -1388,18 +1448,19 @@ doc/zh_*</screen> versions of those files will be written into the specified directory. As long as you have read access to <filename>/usr/src</filename>, you do not even need to be - <username>root</username> to perform this kind of trial run.</para> + <username>root</username> to perform this kind of trial + run.</para> - <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 when you - run <command>cvsup</command>:</para> + <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 + when you run <command>cvsup</command>:</para> <screen>&prompt.root; <userinput>cvsup -g -L 2 <replaceable>supfile</replaceable></userinput></screen> <para>The <option>-g</option> tells <application>CVSup</application> not to use its GUI. This is - automatic if you are not running X11, but otherwise you have to - specify it.</para> + automatic if you are not running X11, but otherwise you have + to specify it.</para> <para>The <option>-L 2</option> tells <application>CVSup</application> to print out the @@ -1412,9 +1473,9 @@ doc/zh_*</screen> list of them, type <command>cvsup -H</command>. For more detailed descriptions, see the manual page.</para> - <para>Once you are satisfied with the way updates are working, you - can arrange for regular runs of <application>CVSup</application> - using &man.cron.8;. + <para>Once you are satisfied with the way updates are working, + you can arrange for regular runs of + <application>CVSup</application> using &man.cron.8;. Obviously, you should not let <application>CVSup</application> use its GUI when running it from &man.cron.8;.</para> </sect2> @@ -1449,8 +1510,8 @@ doc/zh_*</screen> <term><literal>distrib release=cvs</literal></term> <listitem> - <para>Files related to the distribution and mirroring - of &os;.</para> + <para>Files related to the distribution and + mirroring of &os;.</para> </listitem> </varlistentry> @@ -1462,33 +1523,36 @@ doc/zh_*</screen> <important id="cvsup-collec-pbase-warn"> <para>If you do not want to update the whole of - <literal>ports-all</literal> (the whole ports tree), - but use one of the subcollections listed below, - make sure that you <emphasis>always</emphasis> update - the <literal>ports-base</literal> subcollection! + <literal>ports-all</literal> (the whole ports + tree), but use one of the subcollections listed + below, make sure that you + <emphasis>always</emphasis> update the + <literal>ports-base</literal> subcollection! Whenever something changes in the ports build infrastructure represented by - <literal>ports-base</literal>, it is virtually certain - that those changes will be used by <quote>real</quote> - ports real soon. Thus, if you only update the - <quote>real</quote> ports and they use some of the new - features, there is a very high chance that their build - will fail with some mysterious error message. The - <emphasis>very first</emphasis> thing to do in this - case is to make sure that your - <literal>ports-base</literal> subcollection is up to - date.</para> + <literal>ports-base</literal>, it is virtually + certain that those changes will be used by + <quote>real</quote> ports real soon. Thus, if + you only update the <quote>real</quote> ports + and they use some of the new features, there is + a very high chance that their build will fail + with some mysterious error message. The + <emphasis>very first</emphasis> thing to do in + this case is to make sure that your + <literal>ports-base</literal> subcollection is + up to date.</para> </important> <important id="cvsup-collec-index-warn"> - <para>If you are going to be building your own local - copy of <filename>ports/INDEX</filename>, you - <emphasis>must</emphasis> accept - <literal>ports-all</literal> (the whole ports tree). - Building <filename>ports/INDEX</filename> with - a partial tree is not supported. See the - <ulink url="&url.books.faq;/applications.html#MAKE-INDEX"> - FAQ</ulink>.</para> + <para>If you are going to be building your own + local copy of <filename>ports/INDEX</filename>, + you <emphasis>must</emphasis> accept + <literal>ports-all</literal> (the whole ports + tree). Building + <filename>ports/INDEX</filename> with a partial + tree is not supported. See the <ulink + url="&url.books.faq;/applications.html#MAKE-INDEX"> + FAQ</ulink>.</para> </important> <variablelist> @@ -1542,19 +1606,19 @@ doc/zh_*</screen> release=cvs</literal></term> <listitem> - <para>The Ports Collection build infrastructure - - various files located in the - <filename>Mk/</filename> and - <filename>Tools/</filename> subdirectories of - <filename>/usr/ports</filename>.</para> + <para>The Ports Collection build + infrastructure - various files located in + the <filename>Mk/</filename> and + <filename>Tools/</filename> subdirectories + of <filename>/usr/ports</filename>.</para> <note> <para>Please see the <link - linkend="cvsup-collec-pbase-warn">important - warning above</link>: you should + linkend="cvsup-collec-pbase-warn">important + warning above</link>: you should <emphasis>always</emphasis> update this - subcollection, whenever you update any part of - the &os; Ports Collection!</para> + subcollection, whenever you update any + part of the &os; Ports Collection!</para> </note> </listitem> </varlistentry> @@ -1674,7 +1738,8 @@ doc/zh_*</screen> release=cvs</literal></term> <listitem> - <para>Monetary, financial and related applications.</para> + <para>Monetary, financial and related + applications.</para> </listitem> </varlistentry> @@ -1863,7 +1928,8 @@ doc/zh_*</screen> release=cvs</literal></term> <listitem> - <para>Software support for <trademark class="trade">Palm</trademark> + <para>Software support for + <trademark class="trade">Palm</trademark> series.</para> </listitem> </varlistentry> @@ -1882,7 +1948,8 @@ doc/zh_*</screen> release=cvs</literal></term> <listitem> - <para>Utilities to manage ports and packages.</para> + <para>Utilities to manage ports and + packages.</para> </listitem> </varlistentry> @@ -2073,9 +2140,13 @@ doc/zh_*</screen> </varlistentry> <varlistentry> - <term><literal>projects-all release=cvs</literal></term> + <term> + <literal>projects-all release=cvs</literal> + </term> + <listitem> - <para>Sources for the &os; projects repository.</para> + <para>Sources for the &os; projects + repository.</para> </listitem> </varlistentry> @@ -2131,18 +2202,23 @@ doc/zh_*</screen> </varlistentry> <varlistentry> - <term><literal>src-crypto release=cvs</literal></term> + <term> + <literal>src-crypto release=cvs</literal> + </term> <listitem> - <para>Cryptography utilities and libraries from - outside the &os; project, used relatively - unmodified + <para>Cryptography utilities and libraries + from outside the &os; project, used + relatively unmodified + (<filename>/usr/src/crypto</filename>).</para> - </listitem> + </listitem> </varlistentry> <varlistentry> - <term><literal>src-eBones release=cvs</literal></term> + <term> + <literal>src-eBones release=cvs</literal> + </term> <listitem> <para>Kerberos and DES @@ -2177,7 +2253,8 @@ doc/zh_*</screen> <listitem> <para>Utilities covered by the GNU Public - License (<filename>/usr/src/gnu</filename>).</para> + License + (<filename>/usr/src/gnu</filename>).</para> </listitem> </varlistentry> @@ -2226,8 +2303,8 @@ doc/zh_*</screen> release=cvs</literal></term> <listitem> - <para>System programs normally executed by other - programs + <para>System programs normally executed by + other programs (<filename>/usr/src/libexec</filename>).</para> </listitem> </varlistentry> @@ -2249,13 +2326,15 @@ doc/zh_*</screen> <listitem> <para>Statically linked programs for emergency - recovery; see &man.rescue.8; + recovery; see &man.rescue.8; (<filename>/usr/src/rescue</filename>).</para> </listitem> </varlistentry> <varlistentry> - <term><literal>src-sbin release=cvs</literal></term> + <term> + <literal>src-sbin release=cvs</literal> + </term> <listitem> <para>System utilities for single-user mode @@ -2346,8 +2425,8 @@ doc/zh_*</screen> <listitem> <para>The <application>CVSup</application> server's own - configuration files. Used by <application>CVSup</application> - mirror sites.</para> + configuration files. Used by + <application>CVSup</application> mirror sites.</para> </listitem> </varlistentry> @@ -2388,22 +2467,22 @@ doc/zh_*</screen> <para>Most &os;-related discussion of <application>CVSup</application> takes place on the - &a.hackers;. New versions of the software are announced there, - as well as on the &a.announce;.</para> + &a.hackers;. New versions of the software are announced + there, as well as on the &a.announce;.</para> <para>For questions or bug reports about <application>CVSup</application> take a look at the <ulink url="http://www.cvsup.org/faq.html#bugreports"> - CVSup FAQ</ulink>.</para> + CVSup FAQ</ulink>.</para> </sect2> <sect2 id="cvsup-mirrors"> - <title>CVSup Sites</title> + <title>CVSup Sites</title> - <para><link linkend="cvsup">CVSup</link> servers for &os; are running - at the following sites:</para> + <para><link linkend="cvsup">CVSup</link> servers for &os; are + running at the following sites:</para> - &chap.mirrors.cvsup.inc; + &chap.mirrors.cvsup.inc; </sect2> </sect1> @@ -2412,805 +2491,808 @@ doc/zh_*</screen> <para>When obtaining or updating sources using <application>cvs</application> or - <application>CVSup</application>, a revision tag must be specified. - A revision tag refers to either a particular line of &os; - development, or a specific point in time. The first type are called - <quote>branch tags</quote>, and the second type are called - <quote>release tags</quote>.</para> + <application>CVSup</application>, a revision tag must be + specified. A revision tag refers to either a particular line of + &os; development, or a specific point in time. The first type + are called <quote>branch tags</quote>, and the second type are + called <quote>release tags</quote>.</para> <sect2> <title>Branch Tags</title> - <para>All of these, with the exception of <literal>HEAD</literal> (which - is always a valid tag), only apply to the <filename>src/</filename> - tree. The <filename>ports/</filename>, <filename>doc/</filename>, and + <para>All of these, with the exception of + <literal>HEAD</literal> (which is always a valid tag), only + apply to the <filename>src/</filename> tree. The + <filename>ports/</filename>, <filename>doc/</filename>, and <filename>www/</filename> trees are not branched.</para> - <variablelist> - <varlistentry> - <term>HEAD</term> + <variablelist> + <varlistentry> + <term>HEAD</term> - <listitem> - <para>Symbolic name for the main line, or &os;-CURRENT. - Also the default when no revision is specified.</para> - - <para>In <application>CVSup</application>, this tag is represented - by a <literal>.</literal> (not punctuation, but a literal - <literal>.</literal> character).</para> - - <note> - <para>In CVS, this is the default when no revision tag is - specified. It is usually <emphasis>not</emphasis> - a good idea to checkout or update to CURRENT sources - on a STABLE machine, unless that is your intent.</para> - </note> - </listitem> - </varlistentry> + <listitem> + <para>Symbolic name for the main line, or &os;-CURRENT. + Also the default when no revision is specified.</para> + + <para>In <application>CVSup</application>, this tag is + represented by a <literal>.</literal> (not punctuation, + but a literal <literal>.</literal> character).</para> + + <note> + <para>In CVS, this is the default when no revision tag + is specified. It is usually <emphasis>not</emphasis> + a good idea to checkout or update to CURRENT sources + on a STABLE machine, unless that is your + intent.</para> + </note> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_9</term> + <varlistentry> + <term>RELENG_9</term> - <listitem> - <para>The line of development for &os;-9.X, also known - as &os; 9-STABLE</para> - </listitem> - </varlistentry> + <listitem> + <para>The line of development for &os;-9.X, also known + as &os; 9-STABLE</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_9_0</term> + <varlistentry> + <term>RELENG_9_0</term> - <listitem> - <para>The release branch for &os;-9.0, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-9.0, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_8</term> + <varlistentry> + <term>RELENG_8</term> - <listitem> - <para>The line of development for &os;-8.X, also known - as &os; 8-STABLE</para> - </listitem> - </varlistentry> + <listitem> + <para>The line of development for &os;-8.X, also known + as &os; 8-STABLE</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_8_3</term> + <varlistentry> + <term>RELENG_8_3</term> - <listitem> - <para>The release branch for &os;-8.3, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-8.3, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_8_2</term> + <varlistentry> + <term>RELENG_8_2</term> - <listitem> - <para>The release branch for &os;-8.2, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-8.2, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_8_1</term> + <varlistentry> + <term>RELENG_8_1</term> - <listitem> - <para>The release branch for &os;-8.1, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-8.1, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_8_0</term> + <varlistentry> + <term>RELENG_8_0</term> - <listitem> - <para>The release branch for &os;-8.0, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-8.0, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_7</term> + <varlistentry> + <term>RELENG_7</term> - <listitem> - <para>The line of development for &os;-7.X, also known - as &os; 7-STABLE</para> - </listitem> - </varlistentry> + <listitem> + <para>The line of development for &os;-7.X, also known + as &os; 7-STABLE</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_7_4</term> + <varlistentry> + <term>RELENG_7_4</term> - <listitem> - <para>The release branch for &os;-7.4, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-7.4, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_7_3</term> + <varlistentry> + <term>RELENG_7_3</term> - <listitem> - <para>The release branch for &os;-7.3, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-7.3, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_7_2</term> + <varlistentry> + <term>RELENG_7_2</term> - <listitem> - <para>The release branch for &os;-7.2, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-7.2, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_7_1</term> + <varlistentry> + <term>RELENG_7_1</term> - <listitem> - <para>The release branch for &os;-7.1, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-7.1, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_7_0</term> + <varlistentry> + <term>RELENG_7_0</term> - <listitem> - <para>The release branch for &os;-7.0, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-7.0, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_6</term> + <varlistentry> + <term>RELENG_6</term> - <listitem> - <para>The line of development for &os;-6.X, also known - as &os; 6-STABLE</para> - </listitem> - </varlistentry> + <listitem> + <para>The line of development for &os;-6.X, also known + as &os; 6-STABLE</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_6_4</term> + <varlistentry> + <term>RELENG_6_4</term> - <listitem> - <para>The release branch for &os;-6.4, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-6.4, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_6_3</term> + <varlistentry> + <term>RELENG_6_3</term> - <listitem> - <para>The release branch for &os;-6.3, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-6.3, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_6_2</term> + <varlistentry> + <term>RELENG_6_2</term> - <listitem> - <para>The release branch for &os;-6.2, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-6.2, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_6_1</term> + <varlistentry> + <term>RELENG_6_1</term> - <listitem> - <para>The release branch for &os;-6.1, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-6.1, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_6_0</term> + <varlistentry> + <term>RELENG_6_0</term> - <listitem> - <para>The release branch for &os;-6.0, used only for - security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-6.0, used only for + security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5</term> + <varlistentry> + <term>RELENG_5</term> - <listitem> - <para>The line of development for &os;-5.X, also known - as &os; 5-STABLE.</para> - </listitem> - </varlistentry> + <listitem> + <para>The line of development for &os;-5.X, also known + as &os; 5-STABLE.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_5</term> + <varlistentry> + <term>RELENG_5_5</term> - <listitem> - <para>The release branch for &os;-5.5, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-5.5, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_4</term> + <varlistentry> + <term>RELENG_5_4</term> - <listitem> - <para>The release branch for &os;-5.4, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-5.4, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_3</term> + <varlistentry> + <term>RELENG_5_3</term> - <listitem> - <para>The release branch for &os;-5.3, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-5.3, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_2</term> + <varlistentry> + <term>RELENG_5_2</term> - <listitem> - <para>The release branch for &os;-5.2 and &os;-5.2.1, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-5.2 and + &os;-5.2.1, used only for security advisories and other + critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_1</term> + <varlistentry> + <term>RELENG_5_1</term> - <listitem> - <para>The release branch for &os;-5.1, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-5.1, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_0</term> + <varlistentry> + <term>RELENG_5_0</term> - <listitem> - <para>The release branch for &os;-5.0, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-5.0, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4</term> + <varlistentry> + <term>RELENG_4</term> - <listitem> - <para>The line of development for &os;-4.X, also known - as &os; 4-STABLE.</para> - </listitem> - </varlistentry> + <listitem> + <para>The line of development for &os;-4.X, also known + as &os; 4-STABLE.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_11</term> + <varlistentry> + <term>RELENG_4_11</term> - <listitem> - <para>The release branch for &os;-4.11, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-4.11, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_10</term> + <varlistentry> + <term>RELENG_4_10</term> - <listitem> - <para>The release branch for &os;-4.10, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-4.10, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_9</term> + <varlistentry> + <term>RELENG_4_9</term> - <listitem> - <para>The release branch for &os;-4.9, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-4.9, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_8</term> + <varlistentry> + <term>RELENG_4_8</term> - <listitem> - <para>The release branch for &os;-4.8, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-4.8, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_7</term> + <varlistentry> + <term>RELENG_4_7</term> - <listitem> - <para>The release branch for &os;-4.7, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-4.7, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_6</term> + <varlistentry> + <term>RELENG_4_6</term> - <listitem> - <para>The release branch for &os;-4.6 and &os;-4.6.2, - used only for security advisories and other - critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-4.6 and &os;-4.6.2, + used only for security advisories and other + critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_5</term> + <varlistentry> + <term>RELENG_4_5</term> - <listitem> - <para>The release branch for &os;-4.5, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-4.5, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_4</term> + <varlistentry> + <term>RELENG_4_4</term> - <listitem> - <para>The release branch for &os;-4.4, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-4.4, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_3</term> + <varlistentry> + <term>RELENG_4_3</term> - <listitem> - <para>The release branch for &os;-4.3, used only - for security advisories and other critical fixes.</para> - </listitem> - </varlistentry> + <listitem> + <para>The release branch for &os;-4.3, used only + for security advisories and other critical fixes.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_3</term> + <varlistentry> + <term>RELENG_3</term> - <listitem> - <para>The line of development for &os;-3.X, also known - as 3.X-STABLE.</para> - </listitem> - </varlistentry> + <listitem> + <para>The line of development for &os;-3.X, also known + as 3.X-STABLE.</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_2_2</term> + <varlistentry> + <term>RELENG_2_2</term> - <listitem> - <para>The line of development for &os;-2.2.X, also known - as 2.2-STABLE. This branch is mostly obsolete.</para> - </listitem> - </varlistentry> - </variablelist> + <listitem> + <para>The line of development for &os;-2.2.X, also known + as 2.2-STABLE. This branch is mostly obsolete.</para> + </listitem> + </varlistentry> + </variablelist> </sect2> <sect2> <title>Release Tags</title> - <para>These tags refer to a specific point in time when a particular - version of &os; was released. The release engineering process is - documented in more detail by the + <para>These tags refer to a specific point in time when a + particular version of &os; was released. The release + engineering process is documented in more detail by the <ulink url="&url.base;/releng/">Release Engineering Information</ulink> and - <ulink url="&url.articles.releng;/release-proc.html">Release - Process</ulink> documents. - The <filename class="directory">src</filename> tree uses tag names that - start with <literal>RELENG_</literal> tags. - The <filename class="directory">ports</filename> and - <filename class="directory">doc</filename> trees use tags whose names - begin with <literal>RELEASE</literal> tags. - Finally, the <filename class="directory">www</filename> tree is not - tagged with any special name for releases.</para> + <ulink url="&url.articles.releng;/release-proc.html">Release + Process</ulink> documents. The + <filename class="directory">src</filename> tree uses tag names + that start with <literal>RELENG_</literal> tags. The + <filename class="directory">ports</filename> and + <filename class="directory">doc</filename> trees use tags + whose names begin with <literal>RELEASE</literal> tags. + Finally, the <filename class="directory">www</filename> tree + is not tagged with any special name for releases.</para> - <variablelist> - <varlistentry> - <term>RELENG_9_0_0_RELEASE</term> + <variablelist> + <varlistentry> + <term>RELENG_9_0_0_RELEASE</term> - <listitem> - <para>&os; 9.0</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 9.0</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_8_3_0_RELEASE</term> + <varlistentry> + <term>RELENG_8_3_0_RELEASE</term> - <listitem> - <para>&os; 8.3</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 8.3</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_8_2_0_RELEASE</term> + <varlistentry> + <term>RELENG_8_2_0_RELEASE</term> - <listitem> - <para>&os; 8.2</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 8.2</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_8_1_0_RELEASE</term> + <varlistentry> + <term>RELENG_8_1_0_RELEASE</term> - <listitem> - <para>&os; 8.1</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 8.1</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_8_0_0_RELEASE</term> + <varlistentry> + <term>RELENG_8_0_0_RELEASE</term> - <listitem> - <para>&os; 8.0</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 8.0</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_7_4_0_RELEASE</term> + <varlistentry> + <term>RELENG_7_4_0_RELEASE</term> - <listitem> - <para>&os; 7.4</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 7.4</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_7_3_0_RELEASE</term> + <varlistentry> + <term>RELENG_7_3_0_RELEASE</term> - <listitem> - <para>&os; 7.3</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 7.3</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_7_2_0_RELEASE</term> + <varlistentry> + <term>RELENG_7_2_0_RELEASE</term> - <listitem> - <para>&os; 7.2</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 7.2</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_7_1_0_RELEASE</term> + <varlistentry> + <term>RELENG_7_1_0_RELEASE</term> - <listitem> - <para>&os; 7.1</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 7.1</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_7_0_0_RELEASE</term> + <varlistentry> + <term>RELENG_7_0_0_RELEASE</term> - <listitem> - <para>&os; 7.0</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 7.0</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_6_4_0_RELEASE</term> + <varlistentry> + <term>RELENG_6_4_0_RELEASE</term> - <listitem> - <para>&os; 6.4</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 6.4</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_6_3_0_RELEASE</term> + <varlistentry> + <term>RELENG_6_3_0_RELEASE</term> - <listitem> - <para>&os; 6.3</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 6.3</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_6_2_0_RELEASE</term> + <varlistentry> + <term>RELENG_6_2_0_RELEASE</term> - <listitem> - <para>&os; 6.2</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 6.2</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_6_1_0_RELEASE</term> + <varlistentry> + <term>RELENG_6_1_0_RELEASE</term> - <listitem> - <para>&os; 6.1</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 6.1</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_6_0_0_RELEASE</term> + <varlistentry> + <term>RELENG_6_0_0_RELEASE</term> - <listitem> - <para>&os; 6.0</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 6.0</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_5_0_RELEASE</term> + <varlistentry> + <term>RELENG_5_5_0_RELEASE</term> - <listitem> - <para>&os; 5.5</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 5.5</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_4_0_RELEASE</term> + <varlistentry> + <term>RELENG_5_4_0_RELEASE</term> - <listitem> - <para>&os; 5.4</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 5.4</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_11_0_RELEASE</term> + <varlistentry> + <term>RELENG_4_11_0_RELEASE</term> - <listitem> - <para>&os; 4.11</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.11</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_3_0_RELEASE</term> + <varlistentry> + <term>RELENG_5_3_0_RELEASE</term> - <listitem> - <para>&os; 5.3</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 5.3</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_10_0_RELEASE</term> + <varlistentry> + <term>RELENG_4_10_0_RELEASE</term> - <listitem> - <para>&os; 4.10</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.10</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_2_1_RELEASE</term> + <varlistentry> + <term>RELENG_5_2_1_RELEASE</term> - <listitem> - <para>&os; 5.2.1</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 5.2.1</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_2_0_RELEASE</term> + <varlistentry> + <term>RELENG_5_2_0_RELEASE</term> - <listitem> - <para>&os; 5.2</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 5.2</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_9_0_RELEASE</term> + <varlistentry> + <term>RELENG_4_9_0_RELEASE</term> - <listitem> - <para>&os; 4.9</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.9</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_1_0_RELEASE</term> + <varlistentry> + <term>RELENG_5_1_0_RELEASE</term> - <listitem> - <para>&os; 5.1</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 5.1</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_8_0_RELEASE</term> + <varlistentry> + <term>RELENG_4_8_0_RELEASE</term> - <listitem> - <para>&os; 4.8</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.8</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_5_0_0_RELEASE</term> + <varlistentry> + <term>RELENG_5_0_0_RELEASE</term> - <listitem> - <para>&os; 5.0</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 5.0</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_7_0_RELEASE</term> + <varlistentry> + <term>RELENG_4_7_0_RELEASE</term> - <listitem> - <para>&os; 4.7</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.7</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_6_2_RELEASE</term> + <varlistentry> + <term>RELENG_4_6_2_RELEASE</term> - <listitem> - <para>&os; 4.6.2</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.6.2</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_6_1_RELEASE</term> + <varlistentry> + <term>RELENG_4_6_1_RELEASE</term> - <listitem> - <para>&os; 4.6.1</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.6.1</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_6_0_RELEASE</term> + <varlistentry> + <term>RELENG_4_6_0_RELEASE</term> - <listitem> - <para>&os; 4.6</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.6</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_5_0_RELEASE</term> + <varlistentry> + <term>RELENG_4_5_0_RELEASE</term> - <listitem> - <para>&os; 4.5</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.5</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_4_0_RELEASE</term> + <varlistentry> + <term>RELENG_4_4_0_RELEASE</term> - <listitem> - <para>&os; 4.4</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.4</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_3_0_RELEASE</term> + <varlistentry> + <term>RELENG_4_3_0_RELEASE</term> - <listitem> - <para>&os; 4.3</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.3</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_2_0_RELEASE</term> + <varlistentry> + <term>RELENG_4_2_0_RELEASE</term> - <listitem> - <para>&os; 4.2</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.2</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_1_1_RELEASE</term> + <varlistentry> + <term>RELENG_4_1_1_RELEASE</term> - <listitem> - <para>&os; 4.1.1</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.1.1</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_1_0_RELEASE</term> + <varlistentry> + <term>RELENG_4_1_0_RELEASE</term> - <listitem> - <para>&os; 4.1</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.1</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_4_0_0_RELEASE</term> + <varlistentry> + <term>RELENG_4_0_0_RELEASE</term> - <listitem> - <para>&os; 4.0</para> - </listitem> - </varlistentry> + <listitem> + <para>&os; 4.0</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_3_5_0_RELEASE</term> + <varlistentry> + <term>RELENG_3_5_0_RELEASE</term> - <listitem> - <para>&os;-3.5</para> - </listitem> - </varlistentry> + <listitem> + <para>&os;-3.5</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_3_4_0_RELEASE</term> + <varlistentry> + <term>RELENG_3_4_0_RELEASE</term> - <listitem> - <para>&os;-3.4</para> - </listitem> - </varlistentry> + <listitem> + <para>&os;-3.4</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_3_3_0_RELEASE</term> + <varlistentry> + <term>RELENG_3_3_0_RELEASE</term> - <listitem> - <para>&os;-3.3</para> - </listitem> - </varlistentry> + <listitem> + <para>&os;-3.3</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_3_2_0_RELEASE</term> + <varlistentry> + <term>RELENG_3_2_0_RELEASE</term> - <listitem> - <para>&os;-3.2</para> - </listitem> - </varlistentry> + <listitem> + <para>&os;-3.2</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_3_1_0_RELEASE</term> + <varlistentry> + <term>RELENG_3_1_0_RELEASE</term> - <listitem> - <para>&os;-3.1</para> - </listitem> - </varlistentry> + <listitem> + <para>&os;-3.1</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_3_0_0_RELEASE</term> + <varlistentry> + <term>RELENG_3_0_0_RELEASE</term> - <listitem> - <para>&os;-3.0</para> - </listitem> - </varlistentry> + <listitem> + <para>&os;-3.0</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_2_2_8_RELEASE</term> + <varlistentry> + <term>RELENG_2_2_8_RELEASE</term> - <listitem> - <para>&os;-2.2.8</para> - </listitem> - </varlistentry> + <listitem> + <para>&os;-2.2.8</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_2_2_7_RELEASE</term> + <varlistentry> + <term>RELENG_2_2_7_RELEASE</term> - <listitem> - <para>&os;-2.2.7</para> - </listitem> - </varlistentry> + <listitem> + <para>&os;-2.2.7</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_2_2_6_RELEASE</term> + <varlistentry> + <term>RELENG_2_2_6_RELEASE</term> - <listitem> - <para>&os;-2.2.6</para> - </listitem> - </varlistentry> + <listitem> + <para>&os;-2.2.6</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_2_2_5_RELEASE</term> + <varlistentry> + <term>RELENG_2_2_5_RELEASE</term> - <listitem> - <para>&os;-2.2.5</para> - </listitem> - </varlistentry> + <listitem> + <para>&os;-2.2.5</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_2_2_2_RELEASE</term> + <varlistentry> + <term>RELENG_2_2_2_RELEASE</term> - <listitem> - <para>&os;-2.2.2</para> - </listitem> - </varlistentry> + <listitem> + <para>&os;-2.2.2</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_2_2_1_RELEASE</term> + <varlistentry> + <term>RELENG_2_2_1_RELEASE</term> - <listitem> - <para>&os;-2.2.1</para> - </listitem> - </varlistentry> + <listitem> + <para>&os;-2.2.1</para> + </listitem> + </varlistentry> - <varlistentry> - <term>RELENG_2_2_0_RELEASE</term> + <varlistentry> + <term>RELENG_2_2_0_RELEASE</term> - <listitem> - <para>&os;-2.2.0</para> - </listitem> - </varlistentry> - </variablelist> + <listitem> + <para>&os;-2.2.0</para> + </listitem> + </varlistentry> + </variablelist> </sect2> </sect1> @@ -3239,10 +3321,14 @@ doc/zh_*</screen> <para>Available collections:</para> <itemizedlist> - <listitem><para>ftp: A partial mirror of the &os; FTP - server.</para></listitem> - <listitem><para>&os;: A full mirror of the &os; FTP - server.</para></listitem> + <listitem> + <para>ftp: A partial mirror of the &os; FTP + server.</para> + </listitem> + + <listitem> + <para>&os;: A full mirror of the &os; FTP server.</para> + </listitem> </itemizedlist> </listitem> </varlistentry> @@ -3255,8 +3341,9 @@ doc/zh_*</screen> <para>Available collections:</para> <itemizedlist> - <listitem><para>&os;: A full mirror of the - &os; FTP server.</para></listitem> + <listitem> + <para>&os;: A full mirror of the &os; FTP server.</para> + </listitem> </itemizedlist> </listitem> </varlistentry> @@ -3268,13 +3355,21 @@ doc/zh_*</screen> <para>rsync://ftp.mtu.ru/</para> <para>Available collections:</para> + <itemizedlist> - <listitem><para>&os;: A full mirror of the &os; FTP - server.</para></listitem> - <listitem><para>&os;-gnats: The GNATS bug-tracking - database.</para></listitem> - <listitem><para>&os;-Archive: The mirror of &os; Archive FTP - server.</para></listitem> + <listitem> + <para>&os;: A full mirror of the &os; FTP server.</para> + </listitem> + + <listitem> + <para>&os;-gnats: The GNATS bug-tracking + database.</para> + </listitem> + + <listitem> + <para>&os;-Archive: The mirror of &os; Archive + FTP server.</para> + </listitem> </itemizedlist> </listitem> </varlistentry> @@ -3287,8 +3382,9 @@ doc/zh_*</screen> <para>Available collections:</para> <itemizedlist> - <listitem><para>&os;: A full mirror of the &os; FTP - server.</para></listitem> + <listitem> + <para>&os;: A full mirror of the &os; FTP server.</para> + </listitem> </itemizedlist> </listitem> </varlistentry> @@ -3298,13 +3394,16 @@ doc/zh_*</screen> <listitem> <para>rsync://ftp.tw.FreeBSD.org/</para> + <para>rsync://ftp2.tw.FreeBSD.org/</para> + <para>rsync://ftp6.tw.FreeBSD.org/</para> <para>Available collections:</para> <itemizedlist> - <listitem><para>&os;: A full mirror of the &os; FTP - server.</para></listitem> + <listitem> + <para>&os;: A full mirror of the &os; FTP server.</para> + </listitem> </itemizedlist> </listitem> </varlistentry> @@ -3317,8 +3416,10 @@ doc/zh_*</screen> <para>Available collections:</para> <itemizedlist> - <listitem><para>sites/ftp.freebsd.org: A full mirror of the - &os; FTP server.</para></listitem> + <listitem> + <para>sites/ftp.freebsd.org: A full mirror of the &os; + FTP server.</para> + </listitem> </itemizedlist> </listitem> </varlistentry> @@ -3333,18 +3434,24 @@ doc/zh_*</screen> sites.</para> <para>Available collections:</para> <itemizedlist> - <listitem><para>&os;: The master archive of the &os; - FTP server.</para></listitem> - <listitem><para>acl: The &os; master ACL - list.</para></listitem> + <listitem> + <para>&os;: The master archive of the &os; FTP + server.</para> + </listitem> + + <listitem> + <para>acl: The &os; master ACL list.</para> + </listitem> </itemizedlist> <para>rsync://ftp13.FreeBSD.org/</para> <para>Available collections:</para> + <itemizedlist> - <listitem><para>&os;: A full mirror of the &os; FTP - server.</para></listitem> + <listitem> + <para>&os;: A full mirror of the &os; FTP server.</para> + </listitem> </itemizedlist> </listitem> </varlistentry> |