svn commit: r42389 - head/en_US.ISO8859-1/books/fdp-primer/writing-style

[Warren Block]

Author: wblock
Date: Mon Jul 22 23:56:53 2013
New Revision: 42389
URL: http://svnweb.freebsd.org/changeset/doc/42389

Log:
  Fix a spelling error and simplify the acronym definition paragraph.
  
  Submitted by:	bjk

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 22:22:20 2013	(r42388)
+++ head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml	Mon Jul 22 23:56:53 2013	(r42389)
@@ -282,15 +282,13 @@
     <sect2>
       <title>Acronyms</title>
 
-      <para>Acronyms should be spelled out the first time
+      <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.  Usually, acronyms
-	are defined only one per document.  But they can also be
-	defined the first time they appear in a
-	chapter.</para>
+	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>