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
<tag> must have a matching closing </tag>. 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