White space fix only. Translators can ignore.

Sponsored by:	iXsystems
This commit is contained in:
Dru Lavigne 2014-04-16 21:07:48 +00:00
parent 286b399080
commit e5c286ee17
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=44592

View file

@ -11,36 +11,35 @@
<title><acronym>CD</acronym> and <title><acronym>CD</acronym> and
<acronym>DVD</acronym> Sets</title> <acronym>DVD</acronym> Sets</title>
<para>&os; <acronym>CD</acronym> and <acronym>DVD</acronym> sets <para>&os; <acronym>CD</acronym> and <acronym>DVD</acronym> sets
are available from several online are available from several online retailers:</para>
retailers:</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<address>&os; Mall, Inc. <address>&os; Mall, Inc.
<street>2420 Sand Creek Rd C-1 #347</street> <street>2420 Sand Creek Rd C-1 #347</street>
<city>Brentwood</city>, <state>CA</state> <city>Brentwood</city>, <state>CA</state>
<postcode>94513</postcode> <postcode>94513</postcode>
<country>USA</country> <country>USA</country>
Phone: <phone>+1 925 240-6652</phone> Phone: <phone>+1 925 240-6652</phone>
Fax: <fax>+1 925 674-0821</fax> Fax: <fax>+1 925 674-0821</fax>
Email: <email>info@freebsdmall.com</email> Email: <email>info@freebsdmall.com</email>
WWW: <otheraddr WWW: <otheraddr
xlink:href="http://www.freebsdmall.com/">http://www.freebsdmall.com/</otheraddr> xlink:href="http://www.freebsdmall.com/">http://www.freebsdmall.com/</otheraddr>
</address> </address>
</listitem> </listitem>
<listitem> <listitem>
<address>Dr. Hinner EDV <address>Dr. Hinner EDV
<street>Kochelseestr. 11</street> <street>Kochelseestr. 11</street>
<postcode>D-81371</postcode> <city>M&uuml;nchen</city> <postcode>D-81371</postcode> <city>M&uuml;nchen</city>
<country>Germany</country> <country>Germany</country>
Phone: <phone>(0177) 428 419 0</phone> Phone: <phone>(0177) 428 419 0</phone>
Email: <email>infow@hinner.de</email> Email: <email>infow@hinner.de</email>
WWW: <otheraddr WWW: <otheraddr
xlink:href="http://www.hinner.de/linux/freebsd.html">http://www.hinner.de/linux/freebsd.html</otheraddr> xlink:href="http://www.hinner.de/linux/freebsd.html">http://www.hinner.de/linux/freebsd.html</otheraddr>
</address> </address>
</listitem> </listitem>
<!-- <!--
This site is just showing the Apache test page. This site is just showing the Apache test page.
@ -56,7 +55,7 @@ This site is just showing the Apache test page.
</address> </address>
</listitem> </listitem>
This site doesn't have any products newer than 8.1 which is now EOL'd This site doesn't have any products newer than 8.1 which is now EOL'd
<listitem> <listitem>
<address>The Linux Emporium <address>The Linux Emporium
<street>The Techno Centre, Puma Way</street> <street>The Techno Centre, Puma Way</street>
@ -70,20 +69,20 @@ This site doesn't have any products newer than 8.1 which is now EOL'd
</address> </address>
</listitem> </listitem>
--> -->
<listitem> <listitem>
<address>Linux Center <address>Linux Center
<street>Galernaya Street, 55</street> <street>Galernaya Street, 55</street>
<city>Saint-Petersburg</city> <city>Saint-Petersburg</city>
<postcode>190000</postcode> <postcode>190000</postcode>
<country>Russia</country> <country>Russia</country>
Phone: <phone>+7-812-309-06-86</phone> Phone: <phone>+7-812-309-06-86</phone>
Email: <email>info@linuxcenter.ru</email> Email: <email>info@linuxcenter.ru</email>
WWW: <otheraddr WWW: <otheraddr
xlink:href="http://linuxcenter.ru/shop/freebsd">http://linuxcenter.ru/shop/freebsd</otheraddr> xlink:href="http://linuxcenter.ru/shop/freebsd">http://linuxcenter.ru/shop/freebsd</otheraddr>
</address> </address>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</sect1> </sect1>
<sect1 xml:id="mirrors-ftp"> <sect1 xml:id="mirrors-ftp">
@ -423,23 +422,23 @@ Comment out for now until these can be verified.
<title>Introduction</title> <title>Introduction</title>
<para>As of July 2012, &os; uses <para>As of July 2012, &os; uses
<application>Subversion</application> <application>Subversion</application> as the primary version
as the primary version control control system for storing all of &os;'s source code,
system for storing all of &os;'s source code, documentation, documentation, and the Ports Collection.</para>
and the Ports Collection.</para>
<note> <note>
<para><application>Subversion</application> is generally a developer tool. Most users <para><application>Subversion</application> is generally a
should use <command>freebsd-update</command> (<xref developer tool. Most users should use
<command>freebsd-update</command> (<xref
linkend="updating-upgrading-freebsdupdate"/>) to update linkend="updating-upgrading-freebsdupdate"/>) to update
the &os; base system, and <command>portsnap</command> (<xref the &os; base system, and <command>portsnap</command> (<xref
linkend="ports-using"/>) to linkend="ports-using"/>) to update the &os; Ports
update the &os; Ports Collection.</para> Collection.</para>
</note> </note>
<para>This chapter demonstrates how to install <para>This chapter demonstrates how to install
<application>Subversion</application> on a &os; system and then <application>Subversion</application> on a &os; system and
use it to create a local copy of a &os; repository. It then use it to create a local copy of a &os; repository. It
includes a list of the available &os; includes a list of the available &os;
<application>Subversion</application> mirrors and resources to <application>Subversion</application> mirrors and resources to
additional information on how to use additional information on how to use
@ -489,14 +488,15 @@ Comment out for now until these can be verified.
</warning> </warning>
<para><application>Subversion</application> uses <para><application>Subversion</application> uses
<acronym>URL</acronym>s to designate a repository, taking the form of <acronym>URL</acronym>s to designate a repository, taking the
<replaceable>protocol://hostname/path</replaceable>. Mirrors form of <replaceable>protocol://hostname/path</replaceable>.
may support different protocols as specified below. The first Mirrors may support different protocols as specified below.
component of the path is the &os; repository to access. There The first component of the path is the &os; repository to
are three different repositories, <literal>base</literal> for access. There are three different repositories,
the &os; base system source code, <literal>ports</literal> for <literal>base</literal> for the &os; base system source code,
the Ports Collection, and <literal>doc</literal> for <literal>ports</literal> for the Ports Collection, and
documentation. For example, the URL <literal>doc</literal> for documentation. For example, the
URL
<literal>svn://svn0.us-east.FreeBSD.org/ports/head/</literal> <literal>svn://svn0.us-east.FreeBSD.org/ports/head/</literal>
specifies the main branch of the ports repository on the specifies the main branch of the ports repository on the
<systemitem <systemitem
@ -594,112 +594,115 @@ Comment out for now until these can be verified.
&prompt.root; <userinput>make update SVN_UPDATE=yes</userinput></screen> &prompt.root; <userinput>make update SVN_UPDATE=yes</userinput></screen>
</sect2> </sect2>
<sect2 xml:id="svn-mirrors"> <sect2 xml:id="svn-mirrors">
<title><application>Subversion</application> Mirror Sites</title> <title><application>Subversion</application> Mirror
Sites</title>
<indexterm> <indexterm>
<primary>Subversion Repository</primary> <primary>Subversion Repository</primary>
<secondary>Mirror Sites</secondary> <secondary>Mirror Sites</secondary>
</indexterm> </indexterm>
<para>All mirrors carry all repositories.</para> <para>All mirrors carry all repositories.</para>
<para>The master &os; <application>Subversion</application> <para>The master &os; <application>Subversion</application>
server, <systemitem server, <systemitem
class="fqdomainname">svn.FreeBSD.org</systemitem>, is class="fqdomainname">svn.FreeBSD.org</systemitem>, is
publicly accessible, read-only. That may change in the future, publicly accessible, read-only. That may change in the
so users are encouraged to use one of the official mirrors. To future, so users are encouraged to use one of the official
view the &os; <application>Subversion</application> repositories mirrors. To view the &os;
through a browser, use <link <application>Subversion</application> repositories through a
xlink:href="http://svnweb.FreeBSD.org/">http://svnweb.FreeBSD.org/</link>.</para> browser, use <link
xlink:href="http://svnweb.FreeBSD.org/">http://svnweb.FreeBSD.org/</link>.</para>
<note> <note>
<para>The &os; <application>Subversion</application> mirror network is still in its early days, <para>The &os; <application>Subversion</application> mirror
and will likely change. Do not count on this list of mirrors network is still in its early days, and will likely change.
being static. In particular, the <acronym>SSL</acronym> certificates of the Do not count on this list of mirrors being static. In
servers will likely change at some point.</para> particular, the <acronym>SSL</acronym> certificates of the
</note> servers will likely change at some point.</para>
</note>
<informaltable> <informaltable>
<tgroup cols="4"> <tgroup cols="4">
<colspec colwidth="3*"/> <colspec colwidth="3*"/>
<colspec colwidth="1*"/> <colspec colwidth="1*"/>
<colspec colwidth="2*"/> <colspec colwidth="2*"/>
<colspec colwidth="10*"/> <colspec colwidth="10*"/>
<thead> <thead>
<row> <row>
<entry>Name</entry> <entry>Name</entry>
<entry>Protocols</entry> <entry>Protocols</entry>
<entry>Location</entry> <entry>Location</entry>
<entry><acronym>SSL</acronym> Fingerprint</entry> <entry><acronym>SSL</acronym> Fingerprint</entry>
</row> </row>
</thead> </thead>
<tbody> <tbody>
<row> <row>
<entry><systemitem <entry><systemitem
class="fqdomainname">svn0.us-west.FreeBSD.org</systemitem></entry> class="fqdomainname">svn0.us-west.FreeBSD.org</systemitem></entry>
<entry><literal>svn</literal>, <link <entry><literal>svn</literal>, <link
xlink:href="http://svn0.us-west.FreeBSD.org/"><literal>http</literal></link>, xlink:href="http://svn0.us-west.FreeBSD.org/"><literal>http</literal></link>,
<link <link
xlink:href="https://svn0.us-west.FreeBSD.org/"><literal>https</literal></link></entry> xlink:href="https://svn0.us-west.FreeBSD.org/"><literal>https</literal></link></entry>
<entry>USA, California</entry> <entry>USA, California</entry>
<entry>SHA1 <entry>SHA1
<literal>1C:BD:85:95:11:9F:EB:75:A5:4B:C8:A3:FE:08:E4:02:73:06:1E:61</literal></entry> <literal>1C:BD:85:95:11:9F:EB:75:A5:4B:C8:A3:FE:08:E4:02:73:06:1E:61</literal></entry>
</row> </row>
<row> <row>
<entry><systemitem <entry><systemitem
class="fqdomainname">svn0.us-east.FreeBSD.org</systemitem></entry> class="fqdomainname">svn0.us-east.FreeBSD.org</systemitem></entry>
<entry><literal>svn</literal>, <link <entry><literal>svn</literal>, <link
xlink:href="http://svn0.us-east.FreeBSD.org/"><literal>http</literal></link>, xlink:href="http://svn0.us-east.FreeBSD.org/"><literal>http</literal></link>,
<link <link
xlink:href="https://svn0.us-east.FreeBSD.org/"><literal>https</literal></link>, xlink:href="https://svn0.us-east.FreeBSD.org/"><literal>https</literal></link>,
rsync</entry> rsync</entry>
<entry>USA, New Jersey</entry> <entry>USA, New Jersey</entry>
<entry>SHA1 <entry>SHA1
<literal>1C:BD:85:95:11:9F:EB:75:A5:4B:C8:A3:FE:08:E4:02:73:06:1E:61</literal></entry> <literal>1C:BD:85:95:11:9F:EB:75:A5:4B:C8:A3:FE:08:E4:02:73:06:1E:61</literal></entry>
</row> </row>
<row> <row>
<entry><systemitem <entry><systemitem
class="fqdomainname">svn0.eu.FreeBSD.org</systemitem></entry> class="fqdomainname">svn0.eu.FreeBSD.org</systemitem></entry>
<entry><literal>svn</literal>, <link <entry><literal>svn</literal>, <link
xlink:href="http://svn0.eu.FreeBSD.org/"><literal>http</literal></link>, xlink:href="http://svn0.eu.FreeBSD.org/"><literal>http</literal></link>,
<link <link
xlink:href="https://svn0.eu.FreeBSD.org/"><literal>https</literal></link>, xlink:href="https://svn0.eu.FreeBSD.org/"><literal>https</literal></link>,
rsync</entry> rsync</entry>
<entry>Europe, UK</entry> <entry>Europe, UK</entry>
<entry>SHA1 <entry>SHA1
<literal>39:B0:53:35:CE:60:C7:BB:00:54:96:96:71:10:94:BB:CE:1C:07:A7</literal></entry> <literal>39:B0:53:35:CE:60:C7:BB:00:54:96:96:71:10:94:BB:CE:1C:07:A7</literal></entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</informaltable> </informaltable>
<para><acronym>HTTPS</acronym> is the preferred protocol, <para><acronym>HTTPS</acronym> is the preferred protocol,
providing protection against another computer pretending to be providing protection against another computer pretending to be
the &os; mirror (commonly known as a <quote>man in the the &os; mirror (commonly known as a <quote>man in the
middle</quote> attack) or otherwise trying to send bad content middle</quote> attack) or otherwise trying to send bad
to the end user.</para> content to the end user.</para>
<para>On the first connection to an <acronym>HTTPS</acronym> <para>On the first connection to an <acronym>HTTPS</acronym>
mirror, the user will be asked to verify the server mirror, the user will be asked to verify the server
<emphasis>fingerprint</emphasis>:</para> <emphasis>fingerprint</emphasis>:</para>
<screen>Error validating server certificate for 'https://svn0.us-west.freebsd.org:443': <screen>Error validating server certificate for 'https://svn0.us-west.freebsd.org:443':
- The certificate is not issued by a trusted authority. Use the - The certificate is not issued by a trusted authority. Use the
fingerprint to validate the certificate manually! fingerprint to validate the certificate manually!
- The certificate hostname does not match. - The certificate hostname does not match.
@ -710,22 +713,22 @@ Certificate information:
- Fingerprint: 1C:BD:85:95:11:9F:EB:75:A5:4B:C8:A3:FE:08:E4:02:73:06:1E:61 - Fingerprint: 1C:BD:85:95:11:9F:EB:75:A5:4B:C8:A3:FE:08:E4:02:73:06:1E:61
(R)eject, accept (t)emporarily or accept (p)ermanently?</screen> (R)eject, accept (t)emporarily or accept (p)ermanently?</screen>
<para>Compare the fingerprint shown to those listed in the table <para>Compare the fingerprint shown to those listed in the table
above. If the fingerprint matches, the server security above. If the fingerprint matches, the server security
certificate can be accepted temporarily or permanently. A certificate can be accepted temporarily or permanently. A
temporary certificate will expire after a single session with temporary certificate will expire after a single session with
the server, and the verification step will be repeated on the the server, and the verification step will be repeated on the
next connection. Accepting the certificate permanently will next connection. Accepting the certificate permanently will
store the authentication credentials in store the authentication credentials in
<filename>~/.subversion/auth/</filename> and <filename>~/.subversion/auth/</filename> and the user will not
the user will not be asked to verify the fingerprint again until be asked to verify the fingerprint again until the certificate
the certificate expires.</para> expires.</para>
<para>If <literal>https</literal> cannot be used due to firewall <para>If <literal>https</literal> cannot be used due to firewall
or other problems, <literal>svn</literal> is the next choice, or other problems, <literal>svn</literal> is the next choice,
with slightly faster transfers. When neither can be used, use with slightly faster transfers. When neither can be used, use
<literal>http</literal>.</para> <literal>http</literal>.</para>
</sect2> </sect2>
<sect2> <sect2>
<title>For More Information</title> <title>For More Information</title>
@ -737,7 +740,7 @@ Certificate information:
Control with Subversion</link>, or the <link Control with Subversion</link>, or the <link
xlink:href="http://subversion.apache.org/docs/">Subversion xlink:href="http://subversion.apache.org/docs/">Subversion
Documentation</link>.</para> Documentation</link>.</para>
</sect2> </sect2>
</sect1> </sect1>
<sect1 xml:id="mirrors-rsync"> <sect1 xml:id="mirrors-rsync">
@ -745,15 +748,14 @@ Certificate information:
<para>The following sites make &os; available through the rsync <para>The following sites make &os; available through the rsync
protocol. The <application>rsync</application> utility works in protocol. The <application>rsync</application> utility works in
much the same way as the &man.rcp.1; command, much the same way as the &man.rcp.1; command, but has more
but has more options and uses the rsync remote-update protocol options and uses the rsync remote-update protocol which
which transfers only the differences between two sets of files, transfers only the differences between two sets of files, thus
thus greatly speeding up the synchronization over the network. greatly speeding up the synchronization over the network. This
This is most useful if you are a mirror site for the is most useful if you are a mirror site for the &os;
&os; <acronym>FTP</acronym> server, or the CVS repository. The <acronym>FTP</acronym> server, or the CVS repository. The
<application>rsync</application> suite is available for many <application>rsync</application> suite is available for many
operating systems, on &os;, see the operating systems, on &os;, see the <package>net/rsync</package>
<package>net/rsync</package>
port or use the package.</para> port or use the package.</para>
<variablelist> <variablelist>
@ -881,7 +883,9 @@ Certificate information:
<para>This server may only be used by &os; primary mirror <para>This server may only be used by &os; primary mirror
sites.</para> sites.</para>
<para>Available collections:</para> <para>Available collections:</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>&os;: The master archive of the &os; <para>&os;: The master archive of the &os;