svn commit: r39449 - head/en_US.ISO8859-1/books/handbook/mirrors

[Warren Block]

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>