svn commit: r42311 - head/en_US.ISO8859-1/books/fdp-primer/structure

[Warren Block]

Author: wblock
Date: Thu Jul 18 00:49:59 2013
New Revision: 42311
URL: http://svnweb.freebsd.org/changeset/doc/42311

Log:
  A few more simplifications and corrections to the structure chapter.

Modified:
  head/en_US.ISO8859-1/books/fdp-primer/structure/chapter.xml

Modified: head/en_US.ISO8859-1/books/fdp-primer/structure/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/fdp-primer/structure/chapter.xml	Thu Jul 18 00:31:45 2013	(r42310)
+++ head/en_US.ISO8859-1/books/fdp-primer/structure/chapter.xml	Thu Jul 18 00:49:59 2013	(r42311)
@@ -56,7 +56,7 @@
     </listitem>
   </orderedlist>
 
-  <para>In addition, the documentation tree has to accommodate
+  <para>In addition, the documentation tree must accommodate
     documents in many different languages and encodings.  It is
     important that the documentation tree structure does not enforce
     any particular defaults or cultural preferences.</para>
@@ -172,7 +172,7 @@
 
     <para>Not every <filename
 	class="directory"><replaceable>lang</replaceable>.<replaceable>encoding</replaceable></filename>
-      directory will contain all of these subdirectories.  It depends
+      directory will have all of these subdirectories.  It depends
       on how much translation has been accomplished by that
       translation team.</para>
   </sect1>
@@ -189,7 +189,7 @@
       <subtitle><filename>books/handbook/</filename></subtitle>
 
       <para>The Handbook is written in DocBook <acronym>XML</acronym>
-	using the &os; DocBook extended DTD.</para>
+	using the &os; DocBook extended <acronym>DTD</acronym>.</para>
 
       <para>The Handbook is organized as a DocBook
 	<sgmltag>book</sgmltag>.  The book is divided into
@@ -264,7 +264,7 @@
 	  <para>Then it will be called
 	    <filename>chapter.xml</filename> in the
 	    <filename>kernelconfig</filename> directory.  In general,
-	    the entire contents of the chapter will be held in this
+	    the entire contents of the chapter are in this one
 	    file.</para>
 
 	  <para>When the <acronym>XHTML</acronym> version of the
@@ -281,9 +281,9 @@
 	    to include images in each chapter.  Images for each
 	    Handbook chapter are stored within <filename
 	      class="directory">share/images/books/handbook</filename>.
-	    Note that the localized version of these images should be
+	    The localized version of these images should be
 	    placed in the same directory as the <acronym>XML</acronym>
-	    sources for each chapter.  Namespace collisions would be
+	    sources for each chapter.  Namespace collisions are
 	    inevitable, and it is easier to work with several
 	    directories with a few files in them than it is to work
 	    with one directory that has many files in it.</para>