svn commit: r42059 - head/en_US.ISO8859-1/books/fdp-primer/writing-style
Warren Block
wblock at FreeBSD.org
Wed Jun 26 04:24:46 UTC 2013
Author: wblock
Date: Wed Jun 26 04:24:45 2013
New Revision: 42059
URL: http://svnweb.freebsd.org/changeset/doc/42059
Log:
Whitespace-only changes. 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 Wed Jun 26 04:23:10 2013 (r42058)
+++ head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml Wed Jun 26 04:24:45 2013 (r42059)
@@ -71,14 +71,14 @@
rather than <quote>you can copy the file to
<filename>/tmp</filename></quote>.</para>
- <para>Give clear, correct, <emphasis>tested</emphasis> examples. 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 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>
+ <para>Give clear, correct, <emphasis>tested</emphasis> examples.
+ 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
+ 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>
<para>Avoid <emphasis>weasel words</emphasis> like
<quote>should</quote>, <quote>might</quote>,
More information about the svn-doc-all
mailing list