+Thu Nov 7 11:18:42 MST 2002 John Fleck <jfleck@inkstain.net>
+
+ * doc/xsltproc.xml
+ * doc/xsltproc.1
+ clarifying --catalog option and xsltproc's use of
+ XML_CATALOG_FILES and /etc/xml/catalog. fixes
+ http://bugzilla.gnome.org/show_bug.cgi?id=97891
+
Mon Nov 4 06:55:36 CET 2002 Daniel Veillard <daniel@veillard.com>
* xsltproc/xsltproc.c: remove the use of snprintf, and use
| \fB--debug\fR | \fB--novalid\fR | \fB--noout\fR | \fB--maxdepth \fIval\fR\fR
| \fB--html\fR | \fB--docbook\fR | \fB--param \fIname\fR \fIvalue\fR\fR
| \fB--stringparam \fIname\fR \fIvalue\fR\fR | \fB--nonet\fR | \fB--catalogs\fR
- | \fB--xinclude\fR | \fB--profile\fR | \fB--dumpextensions\fR] [\fBstylesheet\fR]
- | \fB--nowrite\fR | \fB--nomkdir\fR
- [\fIfile1\fR] [\fIfile2\fR] [\fI....\fR]
+ | \fB--xinclude\fR | \fB--profile\fR | \fB--dumpextensions\fR | \fB--nowrite\fR
+ | \fB--nomkdir\fR] [\fBstylesheet\fR] [\fIfile1\fR] [\fIfile2\fR] [\fI....\fR]
+
.fi
.SH "INTRODUCTION"
.TP
\fB--catalogs\fR
-Use catalogs to resolve the location of external entities. This speeds DTD resolution. By having a catalog file point to a local version of the DTD, xsltproc does not have to use the Internet to fetch the DTD. xsltproc uses the catalog identified by the environmental variable \fBSGML_CATALOG_FILES\fR.
+Use the SGML catalog specified in \fBSGML_CATALOG_FILES\fR to resolve the location of external entities. By default, xsltproc looks for the catalog specified in \fBXML_CATALOG_FILES\fR. If that is not specified, it uses \fI/etc/xml/catalog\fR.
.TP
\fB--xinclude\fR
<term>
<option>--catalogs</option></term>
<listitem>
- <simpara>Use catalogs to resolve the location of
- external entities. This speeds DTD resolution. By having a
- catalog file point to a local version of the DTD,
- <application>xsltproc</application> does not have to use the
- Internet to fetch the DTD. <application>xsltproc</application>
- uses the catalog identified by the environmental variable
- <envar>SGML_CATALOG_FILES</envar>.
+ <simpara>Use the <acronym>SGML</acronym> catalog specified in
+ <envar>SGML_CATALOG_FILES</envar> to resolve the location of
+ external entities. By default, <application>xsltproc</application>
+ looks for the catalog specified in
+ <envar>XML_CATALOG_FILES</envar>. If that is not specified, it uses
+ <filename>/etc/xml/catalog</filename>.
</simpara>
</listitem>
</varlistentry>