Date: Tue, 24 Jun 2014 15:50:48 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r45115 - head/en_US.ISO8859-1/books/fdp-primer/xml-primer Message-ID: <201406241550.s5OFomXS087900@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201406241550.s5OFomXS087900>