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