From owner-svn-doc-all@freebsd.org Fri Aug 17 14:09:06 2018 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 818CA106FE98; Fri, 17 Aug 2018 14:09:06 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 27A767F930; Fri, 17 Aug 2018 14:09:06 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 031A015BF; Fri, 17 Aug 2018 14:09:06 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w7HE959f048071; Fri, 17 Aug 2018 14:09:05 GMT (envelope-from bcr@FreeBSD.org) Received: (from bcr@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w7HE95nn048070; Fri, 17 Aug 2018 14:09:05 GMT (envelope-from bcr@FreeBSD.org) Message-Id: <201808171409.w7HE95nn048070@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bcr set sender to bcr@FreeBSD.org using -f From: Benedict Reuschling Date: Fri, 17 Aug 2018 14:09:05 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r52148 - head/en_US.ISO8859-1/books/fdp-primer/structure X-SVN-Group: doc-head X-SVN-Commit-Author: bcr X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/fdp-primer/structure X-SVN-Commit-Revision: 52148 X-SVN-Commit-Repository: doc 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.27 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: Fri, 17 Aug 2018 14:09:06 -0000 Author: bcr Date: Fri Aug 17 14:09:05 2018 New Revision: 52148 URL: https://svnweb.freebsd.org/changeset/doc/52148 Log: Properly wrap line that were too long. 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 Fri Aug 17 14:05:29 2018 (r52147) +++ head/en_US.ISO8859-1/books/fdp-primer/structure/chapter.xml Fri Aug 17 14:09:05 2018 (r52148) @@ -29,7 +29,9 @@ POSSIBILITY OF SUCH DAMAGE. --> - + Documentation Directory Structure Files and directories in the @@ -86,10 +88,10 @@ Contains subdirectories to further categorize the information. For example, the files that comprise the &man.make.1; infrastructure are in - share/mk, while - the additional XML support files - (such as the &os; extended DocBook - DTD) are in share/xml. + share/mk, while the additional + XML support files (such as the &os; + extended DocBook DTD) are in + share/xml. @@ -158,8 +160,8 @@ man For translations of the system manual pages. This - directory will contain one or more - manN + directory will contain one or more manN directories, corresponding to the sections that have been translated. @@ -167,10 +169,11 @@ - Not every lang.encoding - directory will have all of these subdirectories. It depends - on how much translation has been accomplished by that - translation team. + Not every lang.encoding + directory will have all of these subdirectories. It depends on + how much translation has been accomplished by that translation + team. @@ -204,8 +207,8 @@ The Handbook's organization may change over time, and this document may lag in detailing the organizational - changes. Post questions about Handbook organization to the - &a.doc;. + changes. Post questions about Handbook organization to + the &a.doc;. @@ -224,21 +227,25 @@ <filename>book.xml</filename> This is the top level document in the Handbook. It - contains the Handbook's DOCTYPE + contains the Handbook's DOCTYPE declaration, as well as the elements that describe the Handbook's structure. - book.xml uses parameter + book.xml uses parameter entities to load in the files with the .ent extension. These files - (described later) then define general + (described later) then define general entities that are used throughout the rest of the Handbook. - <filename role="directory"><replaceable>directory</replaceable>/chapter.xml</filename> + <filename + role="directory"><replaceable>directory</replaceable>/chapter.xml</filename> Each chapter in the Handbook is stored in a file called chapter.xml in a separate @@ -270,15 +277,16 @@ stored in the same directory as book.xml, and named after the value of the id attribute on the file's - chapter element. Now, it is possible - to include images in each chapter. Images for each - Handbook chapter are stored within share/images/books/handbook. - The localized version of these images should be - placed in the same directory as the XML - 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. + chapter element. Now, it is possible to + include images in each chapter. Images for each Handbook + chapter are stored within + share/images/books/handbook. The + localized version of these images should be placed in the + same directory as the XML 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. A brief look will show that there are many directories with individual chapter.xml files,