os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Remove obsolete DocBook SGML setup instructions.

Browse source
This commit is contained in:
Warren Block 2014-06-24 15:50:48 +00:00
parent 79077b5951
commit 38b0baffa3
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=45115
1 changed files with 5 additions and 86 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

91
en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml
View file

@ -360,59 +360,15 @@
<sect2>
<title>To Do&hellip;</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 error : Element head content does not foll
<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">