svn commit: r45115 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer

[Warren Block]

Author: wblock
Date: Tue Jun 24 15:50:48 2014
New Revision: 45115
URL: http://svnweb.freebsd.org/changeset/doc/45115

Log:
  Remove obsolete DocBook SGML setup instructions.

Modified:
  head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml

Modified: head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml	Tue Jun 24 15:45:24 2014	(r45114)
+++ head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml	Tue Jun 24 15:50:48 2014	(r45115)
@@ -360,59 +360,15 @@
     <sect2>
       <title>To Do…</title>
 
-      <para>Before running the examples in this document,
-	application software must be installed and the catalog
-	environment variable configured.</para>
-
-      <procedure>
-	<step>
-	  <para>Install
+      <para>Before running the examples in this document, install
 	    <package>textproc/docproj</package> from
 	    the &os; Ports Collection.  This is a
 	    <emphasis>meta-port</emphasis> that downloads and installs
 	    the standard programs and supporting files needed by the
-	    Documentation Project.</para>
-	</step>
-
-	<step>
-	  <para>Add lines to the shell startup files to set
-	    <envar>SGML_CATALOG_FILES</envar>.  When working on
-	    non-English versions of the documentation, replace
-	    <replaceable>en_US.ISO8859-1</replaceable> with the
-	    appropriate directory for the target language.</para>
-
-	  <example xml:id="xml-primer-envars">
-	    <title><filename>.profile</filename>, for &man.sh.1; and
-	      &man.bash.1; Users</title>
-
-	    <programlisting>SGML_ROOT=/usr/local/share/xml
-SGML_CATALOG_FILES=${SGML_ROOT}/jade/catalog
-SGML_CATALOG_FILES=${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
-SGML_CATALOG_FILES=${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
-SGML_CATALOG_FILES=${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
-SGML_CATALOG_FILES=/usr/doc/share/xml/catalog:$SGML_CATALOG_FILES
-SGML_CATALOG_FILES=/usr/doc/<replaceable>en_US.ISO8859-1</replaceable>/share/xml/catalog:$SGML_CATALOG_FILES
-export SGML_CATALOG_FILES</programlisting>
-	  </example>
-
-	  <example>
-	    <title><filename>.cshrc</filename>, for &man.csh.1; and
-	      &man.tcsh.1; Users</title>
-
-	    <programlisting>setenv SGML_ROOT /usr/local/share/xml
-setenv SGML_CATALOG_FILES ${SGML_ROOT}/jade/catalog
-setenv SGML_CATALOG_FILES ${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
-setenv SGML_CATALOG_FILES ${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
-setenv SGML_CATALOG_FILES ${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
-setenv SGML_CATALOG_FILES /usr/doc/share/xml/catalog:$SGML_CATALOG_FILES
-setenv SGML_CATALOG_FILES /usr/doc/<replaceable>en_US.ISO8859-1</replaceable>/share/xml/catalog:$SGML_CATALOG_FILES</programlisting>
-	  </example>
-
-	  <para>After making these changes, either log out and log
-	    back in again, or run the commands from the command line
-	    to set the variable values.</para>
-	</step>
-      </procedure>
+	    Documentation Project.  &man.csh.1; users must use
+	    <command>rehash</command> for the shell to recognize new
+	    programs after after they have been installed, or log out
+	    and then log back in again.</para>
 
       <procedure>
 	<step>
@@ -711,43 +667,6 @@ example.xml:5: element head: validity er
 	  <acronym>DTD</acronym>s that were installed as part of the
 	  <package>textproc/docproj</package> port.</para>
       </sect3>
-
-      <sect3>
-	<title><envar>SGML_CATALOG_FILES</envar></title>
-
-	<para>To locate a <filename>catalog</filename>, the
-	  <acronym>XML</acronym> processor must know where to look.
-	  Many feature command line parameters for specifying the path
-	  to one or more catalogs.</para>
-
-	<para>In addition, <envar>SGML_CATALOG_FILES</envar> can be
-	  set to point to the files.  This environment variable
-	  consists of a colon-separated list of catalog files
-	  (including their full path).</para>
-
-	<para>Typically, the list includes these files:</para>
-
-	<itemizedlist>
-	  <listitem>
-	    <para><filename>/usr/local/share/xml/docbook/4.1/catalog</filename></para>
-	  </listitem>
-
-	  <listitem>
-	    <para><filename>/usr/local/share/xml/html/catalog</filename></para>
-	  </listitem>
-
-	  <listitem>
-	    <para><filename>/usr/local/share/xml/iso8879/catalog</filename></para>
-	  </listitem>
-
-	  <listitem>
-	    <para><filename>/usr/local/share/xml/jade/catalog</filename></para>
-	  </listitem>
-	</itemizedlist>
-
-	<para>This was done
-	  <link linkend="xml-primer-envars">earlier</link>.</para>
-      </sect3>
     </sect2>
 
     <sect2 xml:id="xml-primer-fpi-alternatives">