Index: appendix.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/fdp-primer/examples/appendix.sgml,v
retrieving revision 1.17
diff -u -r1.17 appendix.sgml
--- appendix.sgml	5 Jan 2006 20:03:35 -0000	1.17
+++ appendix.sgml	26 Dec 2008 02:03:34 -0000
@@ -90,12 +90,12 @@
   </preface>
       
   <chapter>
-    <title>My first chapter</title>
+    <title>My First Chapter</title>
 
     <para>This is the first chapter in my book.</para>
 
     <sect1>
-      <title>My first section</title>
+      <title>My First Section</title>
 
       <para>This is the first section in my book.</para>
     </sect1>
@@ -114,7 +114,7 @@
 
 <article>
   <articleinfo>
-    <title>An example article</title>
+    <title>An Example Article</title>
 
     <author>
       <firstname>Your first name</firstname>
@@ -135,12 +135,12 @@
   </articleinfo>
 
   <sect1>
-    <title>My first section</title>
+    <title>My First Section</title>
 
     <para>This is the first section in my article.</para>
 
     <sect2>
-      <title>My first sub-section</title>
+      <title>My First Sub-Section</title>
 
       <para>This is the first sub-section in my article.</para>
     </sect2>	
@@ -150,7 +150,7 @@
   </sect1>
 
   <sect1 id="examples-formatted">
-    <title>Producing formatted output</title>
+    <title>Producing Formatted Output</title>
 
     <para>This section assumes that you have installed the software listed in
       the <filename role="package">textproc/docproj</filename> port, either by hand, or by
@@ -171,37 +171,37 @@
     -c /usr/local/share/sgml/docbook/catalog \
     -c /usr/local/share/sgml/jade/catalog \
     -d /usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl \<co id="examples-co-jade-1-dsssl">
-    -t sgml <co id="examples-co-jade-1-transform"> file.sgml &gt; file.html <co id="examples-co-jade-1-filename"></userinput></screen>
+    -t sgml <co id="examples-co-jade-1-transform"> <replaceable>file</replaceable>.sgml &gt; <replaceable>file</replaceable>.html <co id="examples-co-jade-1-filename"></userinput></screen>
 
 	<calloutlist>
 	  <callout arearefs="examples-co-jade-1-nochunks">
 	    <para>Specifies the <literal>nochunks</literal> parameter to the
 	      stylesheets, forcing all output to be written to
-	      <abbrev>STDOUT</abbrev> (using Norm Walsh's stylesheets).</para>
+	      the standard output (using Norm Walsh's stylesheets).</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-1-catalog">
-	    <para>Specifies the catalogs that Jade will need to process.
+	    <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 DSSSL stylesheets.  The second
 	      contains information about the DocBook DTD.  The third contains
-	      information specific to Jade.</para>
+	      information specific to <application>Jade</application>.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-1-dsssl">
-	    <para>Specifies the full path to the DSSSL stylesheet that Jade
+	    <para>Specifies the full path to the DSSSL stylesheet that <application>Jade</application>
 	      will use when processing the document.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-1-transform">
-	    <para>Instructs Jade to perform a
+	    <para>Instructs <application>Jade</application> to perform a
 	      <emphasis>transformation</emphasis> from one DTD to another.  In 
 	      this case, the input is being transformed from the DocBook DTD
 	      to the HTML DTD.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-1-filename">
-	    <para>Specifies the file that Jade should process, and redirects
+	    <para>Specifies the file that <application>Jade</application> should process, and redirects
 	      output to the specified <filename>.html</filename> file.</para>
 	  </callout>
 	</calloutlist>
@@ -219,7 +219,7 @@
 
 	<calloutlist>
 	  <callout arearefs="examples-co-jade-2-catalog">
-	    <para>Specifies the catalogs that Jade will need to process.
+	    <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 DSSSL stylesheets.  The second
 	      contains information about the DocBook DTD.  The third contains
@@ -227,19 +227,19 @@
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-2-dsssl">
-	    <para>Specifies the full path to the DSSSL stylesheet that Jade
+	    <para>Specifies the full path to the DSSSL stylesheet that <application>Jade</application>
 	      will use when processing the document.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-2-transform">
-	    <para>Instructs Jade to perform a
+	    <para>Instructs <application>Jade</application> to perform a
 	      <emphasis>transformation</emphasis> from one DTD to another.  In 
 	      this case, the input is being transformed from the DocBook DTD
 	      to the HTML DTD.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-2-filename">
-	    <para>Specifies the file that Jade should process.  The
+	    <para>Specifies the file that <application>Jade</application> should process.  The
 	      stylesheets determine how the individual HTML files will be
 	      named, and the name of the <quote>root</quote> file (i.e., the 
 	      one that contains the start of the document.</para>
@@ -256,7 +256,7 @@
 
 	<para>The source SGML file must be converted to a &tex; file.</para>
 
-	<screen>&prompt.user; <userinput>jade -Vtex-backend \ <co id="examples-co-jade-3-tex-backend">
+	<screen>&prompt.user; <userinput>jade -V tex-backend \ <co id="examples-co-jade-3-tex-backend">
     -c /usr/local/share/sgml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-3-catalog">
     -c /usr/local/share/sgml/docbook/catalog \
     -c /usr/local/share/sgml/jade/catalog \
@@ -270,7 +270,7 @@
 	  </callout>
 	  
 	  <callout arearefs="examples-co-jade-3-catalog">
-	    <para>Specifies the catalogs that Jade will need to process. Three
+	    <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 DSSSL stylesheets.  The second contains
 	      information about the DocBook DTD.  The third contains
@@ -279,11 +279,11 @@
 
 	  <callout arearefs="examples-co-jade-3-dsssl">
 	    <para>Specifies the full path to the DSSSL stylesheet that
-	      Jade will use when processing the document.</para>
+	      <application>Jade</application> will use when processing the document.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-3-tex">
-	    <para>Instructs Jade to convert the output to &tex;.</para>
+	    <para>Instructs <application>Jade</application> to convert the output to &tex;.</para>
 	  </callout>
 	</calloutlist>
 
@@ -300,8 +300,8 @@
 	  on.</para>
 
 	<para>Do not be alarmed if you see warning messages such as
-	  <literal>LaTeX Warning: Reference `136' on page 5 undefined on input
-	  line 728.</literal> at this point.</para>
+	  <errorname>LaTeX Warning: Reference `136' on page 5 undefined on input
+	  line 728.</errorname> at this point.</para>
 	
 	<para>The second run reprocesses the document now that certain pieces
 	  of information are known (such as the document's page length).  This
@@ -328,7 +328,7 @@
 	    linkend="examples-docbook-postscript">).</para>
 
 	<para>When the <filename>.tex</filename> file has been generated you
-	  run pdfTeX.  However, use the &amp;pdfjadetex macro package
+	  run <application>pdfTeX</application>.  However, use the <literal>&amp;pdfjadetex</literal> macro package
 	  instead.</para>
 
 	<screen>&prompt.user; <userinput>pdftex "&amp;pdfjadetex" <replaceable>file</replaceable>.tex</userinput></screen>