more XML information

LDP/guide/docbook/LDP-Author-Guide/LDP-Author-Guide.sgml

@@ -28,7 +28,7 @@
 <book>
   <bookinfo>
     <title>LDP Author Guide</title>
-    <pubdate>v3.51 2 Jan, 2001</pubdate>
+    <pubdate>v3.51 5 Jan, 2001</pubdate>
     <author>
       <firstname>Mark</firstname>
       <othername>F.</othername>
@@ -64,9 +64,9 @@
     <revhistory>
       <revision>
         <revnumber>3.51</revnumber>
-        <date>Jan 3, 2001</date>
+        <date>Jan 5, 2001</date>
         <authorinitials>mfk</authorinitials>
-        <revremark>sgedit (now tksgml) is not free, included link for pricing</revremark>
+        <revremark>sgedit (now tksgml) is not free, included link for pricing, more XML info</revremark>
       </revision>
       <revision>
         <revnumber>3.5</revnumber>
@@ -537,7 +537,7 @@ $_toolroot/dsssl/docbook/catalog:$_toolroot/jade-1.2.1/dsssl/catalog</command>
 <prompt moreinfo="none">bash$</prompt> <command>ln -s docbook.cat catalog</command>
 <prompt moreinfo="none">bash$</prompt> <command>export SGML_CATALOG_FILES=$_xml_root/catalog:$_toolroot/dsssl/catalog:\
 $_toolroot/dtd/docbook/catalog</command> <co id="export">
-<prompt moreinfo="none">bash$</prompt> <command>jade -t sgml -i html -d style $_jade_path/pubtext/xml.dcl foo.xml</command> <co id="jadexmlcmd">
+<prompt moreinfo="none">bash$</prompt> <command>jade -t sgml -i html -d <replaceable>style</replaceable> $_jade_path/pubtext/xml.dcl foo.xml</command> <co id="jadexmlcmd">
             </screen>
             <calloutlist>
             <callout arearefs="export">
@@ -548,9 +548,12 @@ $_toolroot/dtd/docbook/catalog</command> <co id="export">
             </callout>
             <callout arearefs="jadexmlcmd">
               <para>
-                Replace style with the style you wish to use.  The pointer
-                to xml.dcl is requires for jade to work, and it has to be
-                listed immediately before the pointer to your XML document.
+                Replace <replaceable>style</replaceable> with the DSSSL
+                (ldp.dsl) you wish to use.  The pointer to xml.dcl is
+                required for jade to work, and it has to be listed
+                immediately before the pointer to your XML document.
+                This file may be in a different directory.
+                Check your distribution.
               </para>
               <para>
                 You may get the following warnings when processing XML
@@ -1364,7 +1367,7 @@ $_toolroot/dtd/docbook/catalog</command> <co id="export">
       find the original location of your document. </para> 
 
       <section id="validatecode">
-        <title> Validate your SGML code </title>
+        <title>Validating SGML code </title>
         <para> Using jade, or really the nsgmls command, you can
         validate your .sgml code against the DTD to make sure there
         aren't any errors. </para>
@@ -1376,6 +1379,19 @@ $_toolroot/dtd/docbook/catalog</command> <co id="export">
         <para> If there are no issues, you'll just get your command
         prompt back. </para>
       </section>
+      <section id="validatexml">
+        <title>Validating XML code</title>
+        <para>Validating XML is a touch harder than validating SGML
+        code, but can be done.  You will need to have XML DocBook
+        installed, and then set the <envar>SGML_CATALOG_FILES</envar>
+        to the location of xml.soc (included with jade) and to
+        the location of the DocBook XML catalog file.
+        </para>
+        <screen>
+<prompt>bash$</prompt> <command>export <envar>SGML_CATALOG_FILES</envar>=/usr/lib/sgml/declaration/xml.soc:/usr/lib/xml/catalog</command>
+<prompt>bash$</prompt> <command>nsgmls -s HOWTO-HOWTO.xml</command>
+</screen>
+       </section>
     </section>
     
     <section id="makingcopyright">