Re: DOCBOOK-APPS: XML catalog documentation

[Bob Stayton <bobs at caldera dot com>]

On Tue, Nov 12, 2002 at 11:03:37AM +0100, Jeanson Mauritz wrote:
> > -----Original Message-----
> > From: Bob Stayton [mailto:bobs@caldera.com]
> > Sent: Monday, November 11, 2002 6:36 PM
> > To: Jeanson Mauritz; docbook-apps@lists.oasis-open.org
> > Subject: Re: DOCBOOK-APPS: XML catalog documentation
> > 
> > 
> > On Mon, Nov 11, 2002 at 11:00:05AM +0100, Jeanson Mauritz wrote:
> > > > -----Original Message-----
> > > > From: Bob Stayton [mailto:bobs@caldera.com]
> > > > Sent: Monday, November 11, 2002 10:44 AM
> > > > To: docbook-apps@lists.oasis-open.org
> > > > Subject: DOCBOOK-APPS: XML catalog documentation
> > > > 
> > > > 
> > > > I've rewritten my chapter on using XML catalogs with
> > > > DocBook XSL so that it is more complete and accurate.  It
> > > > is available at
> > > > 
> > > > http://www.sagehill.net/xml/docbookxsl/Catalogs.html
> > > > 
> > > > Comments welcome.
> > > 
> > > 
> > > The command line example for Saxon does not work for me:
> > > 
> > > "Error
> > >   Failure reading file://C:/XMLtest/catalogs/test/Saxon/kprof.xml: C
> > > Transformation failed: Run-time errors were reported"
> > >  
> > > To get it to work, I must put "file:" in front of the XML 
> > file name. 
> > 
> > Hmm, I'm able to resolve plain filenames on the command
> > line for the stylesheet and the xml input file as long as I
> > use the -u option for Saxon.  I presume you are doing
> > that.
> 
> 
> Yes, I am doing that.
> 
>  
> > Can you turn on debugging by adding -Ddebug just
> > after "java" to see what it is trying to resolve
> > and how it is resolving it?  It will report
> > 
> > Resolved URI:
> >        somepath
> > 
> > when it succeeds.
> 
> 
> The logs from resolving the XML file name look like this.
> 
> Without "file:" in front of the XML file name:
> 
> resolveURI(kprof.xml)
> resolveURI(kprof.xml)
> Resolved URI: kprof.xml
> 	file://C:/XMLtest/catalogs/test/Saxon/kprof.xml 

I'm not clear on how this is wrong.
It is a full path URI to the file on a Windows system.
Is this not the correct location for the file?
If it is correct, is Saxon unable to open it?
Did this come from a catalog entry, or 
is this the directory from which you are running
the command?

> 
> With "file:" in front of the XML file name:
> 
> resolveURI(file:kprof.xml)
> Resolved URI: file:kprof.xml
> 	file:kprof.xml
>
> 
> I am not sure I understand the use of -Ddebug. Did you mean 
> that it should give me more information than setting verbosity=4
> in CatalogManager.properties? I can't see that it does.

My mistake.  -Ddebug doesn't help with catalog resolution.
I was using it for something else.  verbosity=4 is the
right thing.

-- 

Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
Caldera International, Inc.                 fax:   (831) 429-1887
                                            email: bobs@caldera.com