Date: Wed, 19 Sep 2012 17:22:29 +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: r39580 - head/en_US.ISO8859-1/books/porters-handbook Message-ID: <201209191722.q8JHMU1S033552@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201209191722.q8JHMU1S033552>