Add some commas and markup, minor edits for clarity.

Reviewed by:	simon
This commit is contained in:
Warren Block 2012-08-26 13:19:19 +00:00
parent f1e29076fc
commit 7006d6d31c
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=39449

View file

@ -234,50 +234,51 @@
<primary>svn</primary>
</indexterm>
<para>As of July 2012 &os;
<para>As of July 2012, &os;
uses <ulink url="http://subversion.apache.org/">Subversion</ulink>
(svn) as the primary version control system to store all of
&os;'s source code.</para>
(<emphasis>svn</emphasis>) as the primary version control system for storing all of
&os;'s source code, documentation, and the Ports Collection.</para>
<note><para>For most user, instead of using Subversion it is
suggested to use
<note><para>Subversion is generally a developer tool. Most users should use
<link linkend="updating-upgrading-freebsdupdate">FreeBSD
Update</link> for updating the &os; base system, and
Update</link> to update the &os; base system, and
<link linkend="updating-upgrading-portsnap">Portsnap</link>
for &os; Ports Collection.</para></note>
to update the &os; Ports Collection.</para></note>
<para>The &os; mirror network is still in its early days, and will
likely change again, so do not count on this list of mirrors
being static. In particular the SSL certificates of the servers
<para>The &os; svn mirror network is still in its early days, and will
likely change. Do not count on this list of mirrors
being static. In particular, the SSL certificates of the servers
will likely change at some point.</para>
<para>In subversion URLs are always used to designate a
repository. They have the
form <literal>protocol://hostname/path</literal>. Mirrors may
<para>In Subversion, URLs are used to designate a
repository, taking the
form of <literal>protocol://hostname/path</literal>. Mirrors may
support different protocols as specified below. The first
component of the path is the FreeBSD repository to access. There
are three different repositories, base for the &os; Base
are three different repositories, <literal>base</literal> for the &os; Base
system, <literal>ports</literal> for the FreeBSD Ports
Collection, and <literal>doc</literal> for the FreeBSD
Documentation. All mirrors carries all repositories. The URL
for the &os; ports repository's main branch on svn0.FreeBSD.org
using the svn protocol would
be: <literal>svn://svn0.FreeBSD.org/ports/head/</literal>.</para>
Documentation. For example, the URL
<literal>svn://svn0.us-east.FreeBSD.org/ports/head/</literal>
specifies the main branch of the &os; ports repository on the <hostid role="fqdn">svn0.us-east.FreeBSD.org</hostid> mirror,
using the svn protocol.</para>
<para>The master FreeBSD Subversion server,
<literal>svn.FreeBSD.org</literal> is publicly accessible
read-only, but this may change in the future so users are
encouraged to use one of the official mirrors. To browse the
FreeBSD Subversion repositories through a browser,
<para>All mirrors carry all repositories.</para>
<para>The master &os; Subversion server,
<hostid role="fqdn">svn.FreeBSD.org</hostid>, is publicly accessible,
read-only. That may change in the future, so users are
encouraged to use one of the official mirrors. To view the
&os; Subversion repositories through a browser,
use
<ulink url="http://svnweb.FreeBSD.org/">http://svnweb.FreeBSD.org/</ulink>.</para>
<informaltable>
<tgroup cols="3">
<tgroup cols="4">
<colspec colwidth="3*">
<colspec colwidth="1*">
<colspec colwidth="2*">
<colspec colwidth="1*">
<colspec colwidth="1*">
<colspec colwidth="4*">
<colspec colwidth="10*">
<thead>
<row>
<entry>Name</entry>
@ -292,7 +293,7 @@
<tbody>
<row>
<entry>svn0.us-west.FreeBSD.org</entry>
<entry><hostid role="fqdn">svn0.us-west.FreeBSD.org</hostid></entry>
<entry>svn, <ulink url="http://svn0.us-west.FreeBSD.org/base/">http</ulink>,
<ulink url="https://svn0.us-west.FreeBSD.org/base/">https</ulink></entry>
@ -304,7 +305,7 @@
</row>
<row>
<entry>svn0.us-east.FreeBSD.org</entry>
<entry><hostid role="fqdn">svn0.us-east.FreeBSD.org</hostid></entry>
<entry>svn, <ulink url="http://svn0.us-east.FreeBSD.org/base/">http</ulink>,
<ulink url="https://svn0.us-east.FreeBSD.org/base/">https</ulink></entry>