svn commit: r42390 - head/en_US.ISO8859-1/books/fdp-primer/writing-style
Warren Block
wblock at FreeBSD.org
Tue Jul 23 00:00:22 UTC 2013
Author: wblock
Date: Tue Jul 23 00:00:21 2013
New Revision: 42390
URL: http://svnweb.freebsd.org/changeset/doc/42390
Log:
Whitespace-only fixes. Translators, please ignore.
Modified:
head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml
Modified: head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml Mon Jul 22 23:56:53 2013 (r42389)
+++ head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml Tue Jul 23 00:00:21 2013 (r42390)
@@ -75,7 +75,7 @@
A trivial example is better than no example. A good example
is better yet. Do not give bad examples, identifiable by
apologies or sentences like <quote>but really it should never
- be done that way</quote>. Bad examples are worse than no
+ be done that way</quote>. Bad examples are worse than no
examples. Give good examples, because <emphasis>even when
warned not to use the example as shown</emphasis>, the
reader will usually just use the example as shown.</para>
@@ -244,11 +244,10 @@
<application>Emacs</application>.</para>
<para>A period and spaces followed by a capital letter
- does not always mark a new sentence,
- especially in names.
- <quote>Jordan K. Hubbard</quote> is a good example. It has
- a capital <literal>H</literal> following a period and a
- space, and is certainly not a new sentence.</para>
+ does not always mark a new sentence, especially in names.
+ <quote>Jordan K. Hubbard</quote> is a good example. It
+ has a capital <literal>H</literal> following a period and
+ a space, and is certainly not a new sentence.</para>
</listitem>
</varlistentry>
</variablelist>
@@ -282,13 +281,13 @@
<sect2>
<title>Acronyms</title>
- <para>Acronyms should be defined the first time
- they appear in a document, as in: <quote>Network Time Protocol
- (<acronym>NTP</acronym>)</quote>.
- After the acronym has been defined, use
- the acronym alone unless it makes more
- sense contextually to use the whole term. Acronyms are usually
- defined only once per chapter or per document.</para>
+ <para>Acronyms should be defined the first time they appear in a
+ document, as in:
+ <quote>Network Time Protocol (<acronym>NTP</acronym>)</quote>.
+ After the acronym has been defined, use the acronym alone
+ unless it makes more sense contextually to use the whole term.
+ Acronyms are usually defined only once per chapter or per
+ document.</para>
<para>All acronyms should be enclosed in
<sgmltag>acronym</sgmltag> tags.</para>
More information about the svn-doc-all
mailing list