From 8c54a4e4321c48c81baedc0b140c5321d0753ebd Mon Sep 17 00:00:00 2001
From: Michael Lucas <mwlucas@FreeBSD.org>
Date: Thu, 14 Feb 2002 19:31:09 +0000
Subject: [PATCH] Mention what catalog files are.  Also suggest that people set
 the FreeBSD-specific catalog files are set during this tutorial; this will
 answer a common FreeBSD docproj complaint on complaints generated by emacs.

"if it's wrong, fix it" by: nik
---
 .../books/fdp-primer/sgml-primer/chapter.sgml | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
index e85e22eb11..e0a11b412d 100644
--- a/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
+++ b/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
@@ -323,6 +323,14 @@
       simpler just to <emphasis>always</emphasis> quote your attribute
       values.</para>
 
+    <para>The information on attributes, elements, and tags is stored
+      in SGML catalogs.  The various Documentation Project tools use
+      these catalog files to validate your work.  The tools in
+      <port>textproc/docproj</port> include a variety of SGML catalog
+      files.  The FreeBSD Documentation Project includes its own set
+      of catalog files.  Your tools need to know about both sorts of
+      catalog files.</para>
+
     <sect2>
       <title>For you to do&hellip;</title>
 
@@ -341,7 +349,10 @@
 	
         <step>
           <para>Add lines to your shell startup files to set
-            <envar>SGML_CATALOG_FILES</envar>.</para>
+            <envar>SGML_CATALOG_FILES</envar>. (If you are not working
+            on the English version of the documentation, you will want
+            to substitute the correct directory for your
+            language.)</para>
     
 	  <example id="sgml-primer-envars">
 	    <title><filename>.profile</filename>, for &man.sh.1; and
@@ -352,6 +363,8 @@ SGML_CATALOG_FILES=${SGML_ROOT}/jade/catalog
 SGML_CATALOG_FILES=${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
+SGML_CATALOG_FILES=/usr/doc/share/sgml/catalog:$SGML_CATALOG_FILES
+SGML_CATALOG_FILES=/usr/doc/en_US.ISO8859-1/share/sgml/catalog
 export SGML_CATALOG_FILES</programlisting>
 	  </example>
 
@@ -363,7 +376,9 @@ export SGML_CATALOG_FILES</programlisting>
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/jade/catalog
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
-setenv SGML_CATALOG_FILES ${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES</programlisting>
+setenv SGML_CATALOG_FILES ${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
+setenv SGML_CATALOG_FILES=/usr/doc/share/sgml/catalog:$SGML_CATALOG_FILES
+setenv SGML_CATALOG_FILES=/usr/doc/en_US.ISO8859-1/share/sgml/catalog</programlisting>
           </example>
     
           <para>Then either log out, and log back in again, or run those