Date: Tue, 23 Jul 2013 00:00:22 +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: r42390 - head/en_US.ISO8859-1/books/fdp-primer/writing-style Message-ID: <201307230000.r6N00Mje072150@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201307230000.r6N00Mje072150>