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

[Bob Stayton <bobs at sco dot com>]

On Sun, Mar 09, 2003 at 03:02:07PM -0800, Alex Lancaster wrote:
> >>>>> "SB" == Steinar Bang <sb at dod dot 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.
> 
> From Bob's example it seems that the full URI is not necessary, i.e.:
> 
> XML_CATALOG_FILES="catalog /etc/xml/catalog" should work, but I
> haven't tested it.  Should this work according to spec?  Also, will
> xsltproc fetch catalogs over the network?
> i.e. XML_CATALOG_FILES="http://foo.com/bar/catalog.xml";

Actually, I'm changing all my examples to use the proper
file:/// syntax for local references.
The /etc/xml/catalog syntax works on Linux, 
but it isn't really portable.

-- 

Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
The SCO Group                               fax:   (831) 429-1887
                                            email: bobs at sco dot com