svn commit: r42491 - head/en_US.ISO8859-1/articles/committers-guide

[Warren Block]

Author: wblock
Date: Sat Aug  3 14:10:45 2013
New Revision: 42491
URL: http://svnweb.freebsd.org/changeset/doc/42491

Log:
  Clarity and punctuation improvements.

Modified:
  head/en_US.ISO8859-1/articles/committers-guide/article.xml

Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml
==============================================================================
--- head/en_US.ISO8859-1/articles/committers-guide/article.xml	Sat Aug  3 13:33:20 2013	(r42490)
+++ head/en_US.ISO8859-1/articles/committers-guide/article.xml	Sat Aug  3 14:10:45 2013	(r42491)
@@ -379,7 +379,7 @@
       </itemizedlist>
 
       <para>Subversion can be installed from the &os; Ports
-	Collection, by issuing the following commands:</para>
+	Collection by issuing these commands:</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/devel/subversion</userinput>
 &prompt.root; <userinput>make clean install</userinput></screen>
@@ -590,7 +590,7 @@
 	<title>&os; Ports Tree Branches and Layout</title>
 
 	<para>In <literal>svn+ssh://svn.freebsd.org/ports</literal>,
-	  <emphasis>ports</emphasis> refers repository root of the
+	  <emphasis>ports</emphasis> refers to the repository root of the
 	  ports tree.</para>
 
 	<para>In general, most &os; port work will be done within
@@ -710,8 +710,8 @@
 
 	<para>It is possible to anonymously check out the &os;
 	  repository with Subversion.  This will give access to a
-	  read-only tree that can be updated, but not committed
-	  to.  To do this, use the following command:</para>
+	  read-only tree that can be updated, but not committed back
+	  to the main repository.  To do this, use the following command:</para>
 
 	<screen>&prompt.user; <userinput>svn co <replaceable>https://svn0.us-west.FreeBSD.org</replaceable>/base/head /usr/src</userinput></screen>
 
@@ -801,8 +801,8 @@
 
 	<note>
 	  <para>Most new source files should include a
-	    <literal>$&os;$</literal> string in the
-	    new file.  On commit, <command>svn</command> will expand
+	    <literal>$&os;$</literal> string near the start of the
+	    file.  On commit, <command>svn</command> will expand
 	    the <literal>$&os;$</literal> string,
 	    adding the file path, revision number, date and time of
 	    commit, and the username of the committer.  Files which