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