svn commit: r42394 - head/en_US.ISO8859-1/books/fdp-primer/examples
Warren Block
wblock at FreeBSD.org
Tue Jul 23 01:41:38 UTC 2013
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 @@
<appendix id="examples">
<title>Examples</title>
- <para>This appendix contains example <acronym>XML</acronym> files and the commands
- to convert them from one output format to another. After
- installing the Documentation Project tools (see <xref linkend="tools-required"/>),
- these examples can be used directly.</para>
+ <para>This appendix contains example <acronym>XML</acronym> files
+ and the commands to convert them from one output format to
+ another. After installing the Documentation Project tools (see
+ <xref linkend="tools-required"/>), these examples can be used
+ directly.</para>
<para>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 <acronym>XML</acronym> source for this and other documents
- available in the <application>svn</application>
+ examine the <acronym>XML</acronym> source for this and other
+ documents available in the <application>svn</application>
<literal>doc</literal> repository, or available online starting at
<ulink url="http://svnweb.FreeBSD.org/doc/"></ulink>.</para>
<para>To avoid confusion, these examples use the standard DocBook
- 4.1 <acronym>DTD</acronym> 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 <acronym>DTD</acronym> 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.</para>
@@ -156,13 +157,15 @@
<sect1 id="examples-formatted">
<title>Producing Formatted Output</title>
- <para>Before using this examples, install the required tools as shown in <xref linkend="tools-required"/>.</para>
+ <para>Before using this examples, install the required tools as
+ shown in <xref linkend="tools-required"/>.</para>
<sect2>
<title>Using <application>Jade</application></title>
<example>
- <title>Converting DocBook to <acronym>XHTML</acronym> (One Large File)</title>
+ <title>Converting DocBook to <acronym>XHTML</acronym> (One
+ Large File)</title>
<screen>&prompt.user; <userinput>jade -V nochunks \ <co id="examples-co-jade-1-nochunks"/>
-c /usr/local/share/xml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-1-catalog"/>
@@ -183,23 +186,27 @@
<para>Specifies the catalogs that
<application>Jade</application> will need to process.
Three catalogs are required. The first is a catalog
- that contains information about the <acronym>DSSSL</acronym> stylesheets.
- The second contains information about the DocBook <acronym>DTD</acronym>.
- The third contains information specific to
- <application>Jade</application>.</para>
+ that contains information about the
+ <acronym>DSSSL</acronym> stylesheets. The second
+ contains information about the DocBook
+ <acronym>DTD</acronym>. The third contains information
+ specific to <application>Jade</application>.</para>
</callout>
<callout arearefs="examples-co-jade-1-dsssl">
- <para>Specifies the full path to the <acronym>DSSSL</acronym> stylesheet that
+ <para>Specifies the full path to the
+ <acronym>DSSSL</acronym> stylesheet that
<application>Jade</application> will use when processing
the document.</para>
</callout>
<callout arearefs="examples-co-jade-1-transform">
<para>Instructs <application>Jade</application> to perform
- a <emphasis>transformation</emphasis> from one <acronym>DTD</acronym> to
- another. In this case, the input is being transformed
- from the DocBook <acronym>DTD</acronym> to the <acronym>XHTML</acronym> <acronym>DTD</acronym>.</para>
+ a <emphasis>transformation</emphasis> from one
+ <acronym>DTD</acronym> to another. In this case, the
+ input is being transformed from the DocBook
+ <acronym>DTD</acronym> to the <acronym>XHTML</acronym>
+ <acronym>DTD</acronym>.</para>
</callout>
<callout arearefs="examples-co-jade-1-filename">
@@ -212,8 +219,8 @@
</example>
<example>
- <title>Converting DocBook to <acronym>XHTML</acronym> (Several Small
- Files)</title>
+ <title>Converting DocBook to <acronym>XHTML</acronym> (Several
+ Small Files)</title>
<screen>&prompt.user; <userinput>jade \
-c /usr/local/share/xml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-2-catalog"/>
@@ -227,45 +234,50 @@
<para>Specifies the catalogs that
<application>Jade</application> will need to process.
Three catalogs are required. The first is a catalog
- that contains information about the <acronym>DSSSL</acronym> stylesheets.
- The second contains information about the DocBook <acronym>DTD</acronym>.
- The third contains information specific to <application>Jade</application>.</para>
+ that contains information about the
+ <acronym>DSSSL</acronym> stylesheets. The second
+ contains information about the DocBook
+ <acronym>DTD</acronym>. The third contains information
+ specific to <application>Jade</application>.</para>
</callout>
<callout arearefs="examples-co-jade-2-dsssl">
- <para>Specifies the full path to the <acronym>DSSSL</acronym> stylesheet that
+ <para>Specifies the full path to the
+ <acronym>DSSSL</acronym> stylesheet that
<application>Jade</application> will use when processing
the document.</para>
</callout>
<callout arearefs="examples-co-jade-2-transform">
<para>Instructs <application>Jade</application> to perform
- a <emphasis>transformation</emphasis> from one <acronym>DTD</acronym> to
- another. In this case, the input is being transformed
- from the DocBook <acronym>DTD</acronym> to the <acronym>XHTML</acronym> <acronym>DTD</acronym>.</para>
+ a <emphasis>transformation</emphasis> from one
+ <acronym>DTD</acronym> to another. In this case, the
+ input is being transformed from the DocBook
+ <acronym>DTD</acronym> to the <acronym>XHTML</acronym>
+ <acronym>DTD</acronym>.</para>
</callout>
<callout arearefs="examples-co-jade-2-filename">
<para>Specifies the file that
<application>Jade</application> should process. The
- stylesheets determine how the individual <acronym>XHTML</acronym> files will
- be named, and the name of the <quote>root</quote> file,
- the one that contains the start of the
- document.</para>
+ stylesheets determine how the individual
+ <acronym>XHTML</acronym> files will be named, and the
+ name of the <quote>root</quote> file, the one that
+ contains the start of the document.</para>
</callout>
</calloutlist>
- <para>This example may still only generate one <acronym>XHTML</acronym> file,
- depending on the structure of the document you are
- processing, and the stylesheet's rules for splitting
- output.</para>
+ <para>This example may still only generate one
+ <acronym>XHTML</acronym> file, depending on the structure of
+ the document you are processing, and the stylesheet's rules
+ for splitting output.</para>
</example>
<example id="examples-docbook-postscript">
<title>Converting DocBook to &postscript;</title>
- <para>The source <acronym>XML</acronym> file must be converted to a &tex;
- file.</para>
+ <para>The source <acronym>XML</acronym> file must be converted
+ to a &tex; file.</para>
<screen>&prompt.user; <userinput>jade -V tex-backend \ <co id="examples-co-jade-3-tex-backend"/>
-c /usr/local/share/xml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-3-catalog"/>
@@ -284,13 +296,16 @@
<para>Specifies the catalogs that
<application>Jade</application> will need to process.
Three catalogs are required. The first is a catalog
- that contains information about the <acronym>DSSSL</acronym> stylesheets.
- The second contains information about the DocBook <acronym>DTD</acronym>.
- The third contains information specific to <application>Jade</application>.</para>
+ that contains information about the
+ <acronym>DSSSL</acronym> stylesheets. The second
+ contains information about the DocBook
+ <acronym>DTD</acronym>. The third contains information
+ specific to <application>Jade</application>.</para>
</callout>
<callout arearefs="examples-co-jade-3-dsssl">
- <para>Specifies the full path to the <acronym>DSSSL</acronym> stylesheet that
+ <para>Specifies the full path to the
+ <acronym>DSSSL</acronym> stylesheet that
<application>Jade</application> will use when processing
the document.</para>
</callout>
@@ -307,11 +322,11 @@
<screen>&prompt.user; <userinput>tex "&jadetex" <replaceable>file</replaceable>.tex</userinput></screen>
- <para><command>tex</command> commands must be run <emphasis>at
- least</emphasis> 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.</para>
+ <para><command>tex</command> commands must be run
+ <emphasis>at least</emphasis> 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.</para>
<para>Do not be alarmed if you see warning messages such as
<errorname>LaTeX Warning: Reference `136' on page 5
More information about the svn-doc-head
mailing list