DOCBOOK-APPS: Re: srcdir/objdir issues and including variableusability issues with xsltproc

[Alex Lancaster <alexl@users.sourceforge.net>]

>>>>> "SB" == Steinar Bang <sb@dod.no> writes:

[...]

>> XML_CATALOG_FILES=catalog:/etc/xml/catalog should work.

SB> I belive the entries in XML_CATALOG_FILES are expected to be valid
SB> URLs, and that they are to be space separated, ie.

SB> XML_CATALOG_FILES="catalog file:///etc/xml/catalog"

Thanks, I was not aware that it required space-delimiters.  When I
first used xsltproc it did not yet support multiple catalogs, and
assumed that when it was added that it would follow the syntax of
SGML_CATALOG_FILES, which is colon-delimited catalogs.  I see that Bob
Stayton documents this use at:

http://www.sagehill.net/xml/docbookxsl/Catalogs.html

It would be great if xsltproc included this fact in it's man page or
usage screen, which has no mention of multiple catalogs.  Perhaps it
could be amended to read:

 catalogs

  Use the SGML catalog specified in SGML_CATALOG_FILES to resolve the
  location of external entities. By default, xsltproc looks for the
  catalog specified in XML_CATALOG_FILES.  XML_CATALOG_FILES can
  contain multiple catalogs, delimited by spaces.  If no
  XML_CATALOG_FILES are specified, it uses /etc/xml/catalog.