From owner-svn-doc-all@FreeBSD.ORG Thu Jul 18 00:50:00 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 3DA0D393; Thu, 18 Jul 2013 00:50:00 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 15E8085D; Thu, 18 Jul 2013 00:50:00 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6I0nxF1001161; Thu, 18 Jul 2013 00:49:59 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6I0nxLw001160; Thu, 18 Jul 2013 00:49:59 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307180049.r6I0nxLw001160@svn.freebsd.org> From: Warren Block Date: Thu, 18 Jul 2013 00:49:59 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 18 Jul 2013 00:50:00 -0000 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 @@ - In addition, the documentation tree has to accommodate + 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. @@ -172,7 +172,7 @@ Not every lang.encoding - 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. @@ -189,7 +189,7 @@ books/handbook/ The Handbook is written in DocBook XML - using the &os; DocBook extended DTD. + using the &os; DocBook extended DTD. The Handbook is organized as a DocBook book. The book is divided into @@ -264,7 +264,7 @@ Then it will be called chapter.xml in the kernelconfig 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. When the XHTML version of the @@ -281,9 +281,9 @@ to include images in each chapter. Images for each Handbook chapter are stored within share/images/books/handbook. - 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 XML - 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.