From owner-svn-doc-all@FreeBSD.ORG Tue Jul 23 01:41:37 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id E2811D95; Tue, 23 Jul 2013 01:41:37 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id C2E3B2E9B; Tue, 23 Jul 2013 01:41:37 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6N1fbMq004446; Tue, 23 Jul 2013 01:41:37 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6N1fb6e004445; Tue, 23 Jul 2013 01:41:37 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307230141.r6N1fb6e004445@svn.freebsd.org> From: Warren Block Date: Tue, 23 Jul 2013 01:41:37 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42394 - head/en_US.ISO8859-1/books/fdp-primer/examples 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: Tue, 23 Jul 2013 01:41:38 -0000 Author: wblock Date: Tue Jul 23 01:41:37 2013 New Revision: 42394 URL: http://svnweb.freebsd.org/changeset/doc/42394 Log: Whitespace-only fixes. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml Tue Jul 23 01:35:20 2013 (r42393) +++ head/en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml Tue Jul 23 01:41:37 2013 (r42394) @@ -34,23 +34,24 @@ Examples - This appendix contains example XML files and the commands - to convert them from one output format to another. After - installing the Documentation Project tools (see ), - these examples can be used directly. + This appendix contains example XML files + and the commands to convert them from one output format to + another. After installing the Documentation Project tools (see + ), these examples can be used + directly. These examples are not exhaustive—they do not contain all the elements that might be desirable to use, particularly in a document's front matter. For more examples of DocBook markup, - examine the XML source for this and other documents - available in the svn + examine the XML source for this and other + documents available in the svn doc repository, or available online starting at . To avoid confusion, these examples use the standard DocBook - 4.1 DTD rather than the &os; extension. They also use the - stock stylesheets distributed by Norm Walsh, rather than any - customizations made to those stylesheets by the &os; + 4.1 DTD rather than the &os; extension. They + also use the stock stylesheets distributed by Norm Walsh, rather + than any customizations made to those stylesheets by the &os; Documentation Project. This makes them more useful as generic DocBook examples. @@ -156,13 +157,15 @@ Producing Formatted Output - Before using this examples, install the required tools as shown in . + Before using this examples, install the required tools as + shown in . Using <application>Jade</application> - Converting DocBook to <acronym>XHTML</acronym> (One Large File) + Converting DocBook to <acronym>XHTML</acronym> (One + Large File) &prompt.user; jade -V nochunks \ -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ @@ -183,23 +186,27 @@ Specifies the catalogs that Jade will need to process. Three catalogs are required. The first is a catalog - that contains information about the DSSSL stylesheets. - The second contains information about the DocBook DTD. - The third contains information specific to - Jade. + that contains information about the + DSSSL stylesheets. The second + contains information about the DocBook + DTD. The third contains information + specific to Jade. - Specifies the full path to the DSSSL stylesheet that + Specifies the full path to the + DSSSL stylesheet that Jade will use when processing the document. Instructs Jade to perform - a transformation from one DTD to - another. In this case, the input is being transformed - from the DocBook DTD to the XHTML DTD. + a transformation from one + DTD to another. In this case, the + input is being transformed from the DocBook + DTD to the XHTML + DTD. @@ -212,8 +219,8 @@ - Converting DocBook to <acronym>XHTML</acronym> (Several Small - Files) + Converting DocBook to <acronym>XHTML</acronym> (Several + Small Files) &prompt.user; jade \ -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ @@ -227,45 +234,50 @@ Specifies the catalogs that Jade will need to process. Three catalogs are required. The first is a catalog - that contains information about the DSSSL stylesheets. - The second contains information about the DocBook DTD. - The third contains information specific to Jade. + that contains information about the + DSSSL stylesheets. The second + contains information about the DocBook + DTD. The third contains information + specific to Jade. - Specifies the full path to the DSSSL stylesheet that + Specifies the full path to the + DSSSL stylesheet that Jade will use when processing the document. Instructs Jade to perform - a transformation from one DTD to - another. In this case, the input is being transformed - from the DocBook DTD to the XHTML DTD. + a transformation from one + DTD to another. In this case, the + input is being transformed from the DocBook + DTD to the XHTML + DTD. Specifies the file that Jade should process. The - stylesheets determine how the individual XHTML files will - be named, and the name of the root file, - the one that contains the start of the - document. + stylesheets determine how the individual + XHTML files will be named, and the + name of the root file, the one that + contains the start of the document. - This example may still only generate one XHTML file, - depending on the structure of the document you are - processing, and the stylesheet's rules for splitting - output. + This example may still only generate one + XHTML file, depending on the structure of + the document you are processing, and the stylesheet's rules + for splitting output. Converting DocBook to &postscript; - The source XML file must be converted to a &tex; - file. + The source XML file must be converted + to a &tex; file. &prompt.user; jade -V tex-backend \ -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ @@ -284,13 +296,16 @@ Specifies the catalogs that Jade will need to process. Three catalogs are required. The first is a catalog - that contains information about the DSSSL stylesheets. - The second contains information about the DocBook DTD. - The third contains information specific to Jade. + that contains information about the + DSSSL stylesheets. The second + contains information about the DocBook + DTD. The third contains information + specific to Jade. - Specifies the full path to the DSSSL stylesheet that + Specifies the full path to the + DSSSL stylesheet that Jade will use when processing the document. @@ -307,11 +322,11 @@ &prompt.user; tex "&jadetex" file.tex - tex commands must be run at - least three times. The first run processes the - document, and determines areas of the document which are - referenced from other parts of the document, for use in - indexing, and so on. + tex commands must be run + at least three times. The first run + processes the document, and determines areas of the document + which are referenced from other parts of the document, for + use in indexing, and so on. Do not be alarmed if you see warning messages such as LaTeX Warning: Reference `136' on page 5