svn commit: r39580 - head/en_US.ISO8859-1/books/porters-handbook

Warren Block wblock at FreeBSD.org
Wed Sep 19 17:22:30 UTC 2012


Author: wblock
Date: Wed Sep 19 17:22:29 2012
New Revision: 39580
URL: http://svn.freebsd.org/changeset/doc/39580

Log:
  Add commas to "e.g." and "i.e." abbreviations.

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/book.sgml

Modified: head/en_US.ISO8859-1/books/porters-handbook/book.sgml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/book.sgml	Wed Sep 19 16:59:39 2012	(r39579)
+++ head/en_US.ISO8859-1/books/porters-handbook/book.sgml	Wed Sep 19 17:22:29 2012	(r39580)
@@ -895,7 +895,7 @@ DOS2UNIX_REGEX=	.*\.(c|cpp|h)</programli
 
 	  <para>The <makevar>PORTREVISION</makevar> variable is a
 	    monotonically increasing value which is reset to 0 with
-	    every increase of <makevar>PORTVERSION</makevar> (i.e.
+	    every increase of <makevar>PORTVERSION</makevar> (i.e.,
 	    every time a new official vendor release is made), and
 	    appended to the package name if non-zero.  Changes to
 	    <makevar>PORTREVISION</makevar> are used by automated
@@ -3438,7 +3438,7 @@ ALWAYS_KEEP_DISTFILES=	yes
 	</listitem>
 
 	<listitem>
-	  <para>Do not start with an indefinite article (i.e.
+	  <para>Do not start with an indefinite article (i.e.,
 	    A or An);</para>
 	</listitem>
 
@@ -3448,7 +3448,7 @@ ALWAYS_KEEP_DISTFILES=	yes
 	</listitem>
 
 	<listitem>
-	  <para>For lists of words use the Oxford comma (e.g.
+	  <para>For lists of words, use the Oxford comma (e.g.,
 	    green, red<emphasis>,</emphasis> and blue);</para>
 	</listitem>
 
@@ -6938,13 +6938,13 @@ USE_QT4=	moc_build qmake_build rcc_build
 	    <tbody>
 	      <row>
 		<entry><makevar>JAVA_PORT</makevar></entry>
-		<entry>The name of the JDK port (e.g.
+		<entry>The name of the JDK port (e.g.,
 		  <literal>'java/openjdk6'</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_PORT_VERSION</makevar></entry>
-		<entry>The full version of the JDK port (e.g.
+		<entry>The full version of the JDK port (e.g.,
 		  <literal>'1.6.0'</literal>).  If you only need the
 		  first two digits of this version number, use
 		  <makevar>${JAVA_PORT_VERSION:C/^([0-9])\.([0-9])(.*)$/\1.\2/}</makevar>.</entry>
@@ -6952,13 +6952,13 @@ USE_QT4=	moc_build qmake_build rcc_build
 
 	      <row>
 		<entry><makevar>JAVA_PORT_OS</makevar></entry>
-		<entry>The operating system used by the JDK port (e.g.
+		<entry>The operating system used by the JDK port (e.g.,
 		  <literal>'native'</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_PORT_VENDOR</makevar></entry>
-		<entry>The vendor of the JDK port (e.g.
+		<entry>The vendor of the JDK port (e.g.,
 		  <literal>'openjdk'</literal>).</entry>
 	      </row>
 
@@ -6971,7 +6971,7 @@ USE_QT4=	moc_build qmake_build rcc_build
 
 	      <row>
 		<entry><makevar>JAVA_PORT_VENDOR_DESCRIPTION</makevar></entry>
-		<entry>Description of the vendor of the JDK port (e.g.
+		<entry>Description of the vendor of the JDK port (e.g.,
 		  <literal>'OpenJDK BSD Porting
 		    Team'</literal>).</entry>
 	      </row>
@@ -6979,20 +6979,20 @@ USE_QT4=	moc_build qmake_build rcc_build
 	      <row>
 		<entry><makevar>JAVA_HOME</makevar></entry>
 		<entry>Path to the installation directory of the JDK
-		  (e.g.
+		  (e.g.,
 		  <filename>'/usr/local/openjdk6'</filename>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVAC</makevar></entry>
-		<entry>Path to the Java compiler to use (e.g.
+		<entry>Path to the Java compiler to use (e.g.,
 		  <filename>'/usr/local/openjdk6/bin/javac'</filename>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAR</makevar></entry>
 		<entry>Path to the <command>jar</command> tool to use
-		  (e.g.
+		  (e.g.,
 		  <filename>'/usr/local/openjdk6/bin/jar'</filename>
 		  or
 		  <filename>'/usr/local/bin/fastjar'</filename>).</entry>
@@ -7001,14 +7001,14 @@ USE_QT4=	moc_build qmake_build rcc_build
 	      <row>
 		<entry><makevar>APPLETVIEWER</makevar></entry>
 		<entry>Path to the <command>appletviewer</command>
-		  utility (e.g.
+		  utility (e.g.,
 		  <filename>'/usr/local/openjdk6/bin/appletviewer'</filename>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA</makevar></entry>
 		<entry>Path to the <command>java</command> executable.
-		  Use this for executing Java programs (e.g.
+		  Use this for executing Java programs (e.g.,
 		  <filename>'/usr/local/openjdk6/bin/java'</filename>).</entry>
 	      </row>
 
@@ -10827,7 +10827,7 @@ as .putsy.conf and edit it.</programlist
 	  XML tag names are enclosed in angle brackets.  Each opening
 	  &lt;tag&gt; must have a matching closing &lt;/tag&gt;.  Tags
 	  may be nested.  If nesting, the inner tags must be closed
-	  before the outer ones.  There is a hierarchy of tags, i.e.
+	  before the outer ones.  There is a hierarchy of tags, i.e.,
 	  more complex rules of nesting them.  Sounds very similar to
 	  HTML, doesn't it?  The major difference is that XML is
 	  e<emphasis>X</emphasis>tensible, i.e., based on defining
@@ -16336,7 +16336,7 @@ IGNORE=	POINTYHAT is not supported
       <title>Avoiding Linuxisms</title>
 
       <para>Do not use <filename>/proc</filename> if there are any
-	other ways of getting the information, e.g.
+	other ways of getting the information, e.g.,
 	<function>setprogname(argv[0])</function> in
 	<function>main()</function> and then &man.getprogname.3; if
 	you want to <quote>know your name</quote>.</para>
@@ -16393,7 +16393,7 @@ IGNORE=	POINTYHAT is not supported
 	&os;.</para>
 
       <para>Check that headers are included in the
-	<acronym>POSIX</acronym> or man page recommended way, e.g.
+	<acronym>POSIX</acronym> or man page recommended way, e.g.,
 	<filename>sys/types.h</filename> is often forgotten, which is
 	not as much of a problem for &linux; as it is for &os;.</para>
 


More information about the svn-doc-all mailing list