Date: Thu, 18 Jul 2013 00:49:59 +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: r42311 - head/en_US.ISO8859-1/books/fdp-primer/structure Message-ID: <201307180049.r6I0nxLw001160@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201307180049.r6I0nxLw001160>