Date: Sun, 26 Aug 2012 13:19:20 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r39449 - head/en_US.ISO8859-1/books/handbook/mirrors Message-ID: <201208261319.q7QDJKlX027439@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: wblock Date: Sun Aug 26 13:19:19 2012 New Revision: 39449 URL: http://svn.freebsd.org/changeset/doc/39449 Log: Add some commas and markup, minor edits for clarity. Reviewed by: simon Modified: head/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml Modified: head/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml Sun Aug 26 09:00:32 2012 (r39448) +++ head/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml Sun Aug 26 13:19:19 2012 (r39449) @@ -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> - - <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, + 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>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"> - <colspec colwidth="2*"> - <colspec colwidth="1*"> + <tgroup cols="4"> + <colspec colwidth="3*"> <colspec colwidth="1*"> - <colspec colwidth="4*"> + <colspec colwidth="2*"> + <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>;
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201208261319.q7QDJKlX027439>