Problems building the resolver documentation

Hi all,

I tried doing a complete build of the resolver distribution
yesterday and 
got the following errors:

htmldocs:
     [echo] Building docs for xml-commons-resolver ...
     [java] (Location of error unknown)XSLT Error 
(javax.xml.transform.TransformerConfigurationException): 
javax.xml.transform.TransformerException:
java.io.FileNotFoundException: 
C:eclipse3.2.0eclipseworkspacedocbookhtmldocbook.xsl
(The system 
cannot find the path specified)
     [java] Java Result: -1
     [java] Cannot find CatalogManager.properties
     [java] (Location of error unknown)XSLT Error 
(javax.xml.transform.TransformerConfigurationException): 
javax.xml.transform.TransformerException:
java.io.FileNotFoundException: 
C:eclipse3.2.0eclipseworkspacedocbookhtmldocbook.xsl
(The system 
cannot find the path specified)
     [java] Java Result: -1

Obviously I'm missing docbook.xsl, though I can't seem to
find it in SVN. 
There's a comment within the 'htmldocs' target which says:
"Note: The docs 
are built in two ways until we stabilise the doc generation.
Both ways 
have system-specific pathnames, so both may bust on your
system." Has 
anyone managed to build the HTML docs successfully?

Thanks.

Michael Glavassevich
XML Parser Development
IBM Toronto Lab
E-mail: mrglavasca.ibm.com
E-mail: mrglavasapache.org

The DocBook stylesheets don't seem to be in SVN, no. I have
a local
install and when I adjust the path in
src/documentation/sitemap.xmap, it
works for me.

Another trick is to set the URL in sitemap.xmap to
http://docbook.sourceforge.net/release/xsl/c
urrent/xhtml/docbook.xsl
(which loads it directly from the Internet) 

Obviously, that's not optimal. I saw that in Forrest 0.8,
they have a
"Simplified Docbook" Plug-in, but since I'm still
working with the 0.7
branch I haven't tried it, yet. Maybe that would help and
could even
integrate the pages directly within the Forrest site
structure. Maybe
one of the Forrest people here (David?) has a good idea
here. Adding the
DocBook stylesheets to SVN could, of course, be an option
but the XHTML
variant alone uses up 1MB. Not sure what to do here.

DocBook Download:
http://sourceforge.net/project/showfiles.php?gr
oup_id=21935#files

On 20.11.2006 02:58:04 Michael Glavassevich wrote:
> Hi all,
> 
> I tried doing a complete build of the resolver
distribution yesterday and 
> got the following errors:
> 
> htmldocs:
>      [echo] Building docs for xml-commons-resolver ...
>      [java] (Location of error unknown)XSLT Error 
>
(javax.xml.transform.TransformerConfigurationException): 
> javax.xml.transform.TransformerException:
java.io.FileNotFoundException: 
>
C:eclipse3.2.0eclipseworkspacedocbookhtmldocbook.xsl
(The system 
> cannot find the path specified)
>      [java] Java Result: -1
>      [java] Cannot find CatalogManager.properties
>      [java] (Location of error unknown)XSLT Error 
>
(javax.xml.transform.TransformerConfigurationException): 
> javax.xml.transform.TransformerException:
java.io.FileNotFoundException: 
>
C:eclipse3.2.0eclipseworkspacedocbookhtmldocbook.xsl
(The system 
> cannot find the path specified)
>      [java] Java Result: -1
> 
> Obviously I'm missing docbook.xsl, though I can't seem
to find it in SVN. 
> There's a comment within the 'htmldocs' target which
says: "Note: The docs 
> are built in two ways until we stabilise the doc
generation. Both ways 
> have system-specific pathnames, so both may bust on
your system." Has 
> anyone managed to build the HTML docs successfully?
> 
> Thanks.
> 
> Michael Glavassevich
> XML Parser Development
> IBM Toronto Lab
> E-mail: mrglavasca.ibm.com
> E-mail: mrglavasapache.org



Jeremias Maerki

Jeremias Maerki wrote:
> The DocBook stylesheets don't seem to be in SVN, no. I
have a local
> install and when I adjust the path in
src/documentation/sitemap.xmap, it
> works for me.

I think that Norm recently tweaked the build system so that
it doesn't need Forrest to build that Resolver article
document
when building the resolver distribution.
See java/resolver.xml

However it still needs the person running the build to
install
the DocBook XSL on their local system. See notes in the
build file.
Too big to add in to our SVN for such a limited use.

> Another trick is to set the URL in sitemap.xmap to
> http://docbook.sourceforge.net/release/xsl/c
urrent/xhtml/docbook.xsl
> (which loads it directly from the Internet) 
> 
> Obviously, that's not optimal. I saw that in Forrest
0.8, they have a
> "Simplified Docbook" Plug-in, but since I'm
still working with the 0.7
> branch I haven't tried it, yet. Maybe that would help
and could even
> integrate the pages directly within the Forrest site
structure. Maybe
> one of the Forrest people here (David?) has a good idea
here. Adding the
> DocBook stylesheets to SVN could, of course, be an
option but the XHTML
> variant alone uses up 1MB. Not sure what to do here.

I would not recommend doing that. That plugin is too basic.
That is why i set up the Forrest for xml-commons to not
use that.

-David

> DocBook Download:
> http://sourceforge.net/project/showfiles.php?gr
oup_id=21935#files
> 
> On 20.11.2006 02:58:04 Michael Glavassevich wrote:
> > Hi all,
> > 
> > I tried doing a complete build of the resolver
distribution yesterday and 
> > got the following errors:
> > 
> > htmldocs:
> >      [echo] Building docs for xml-commons-resolver
...
> >      [java] (Location of error unknown)XSLT Error 
> >
(javax.xml.transform.TransformerConfigurationException): 
> > javax.xml.transform.TransformerException:
java.io.FileNotFoundException: 
> >
C:eclipse3.2.0eclipseworkspacedocbookhtmldocbook.xsl
(The system 
> > cannot find the path specified)
> >      [java] Java Result: -1
> >      [java] Cannot find CatalogManager.properties
> >      [java] (Location of error unknown)XSLT Error 
> >
(javax.xml.transform.TransformerConfigurationException): 
> > javax.xml.transform.TransformerException:
java.io.FileNotFoundException: 
> >
C:eclipse3.2.0eclipseworkspacedocbookhtmldocbook.xsl
(The system 
> > cannot find the path specified)
> >      [java] Java Result: -1
> > 
> > Obviously I'm missing docbook.xsl, though I can't
seem to find it in SVN. 
> > There's a comment within the 'htmldocs' target
which says: "Note: The docs 
> > are built in two ways until we stabilise the doc
generation. Both ways 
> > have system-specific pathnames, so both may bust
on your system." Has 
> > anyone managed to build the HTML docs
successfully?
> > 
> > Thanks.
> > 
> > Michael Glavassevich
> > XML Parser Development
> > IBM Toronto Lab
> > E-mail: mrglavasca.ibm.com
> > E-mail: mrglavasapache.org
> 
> 
> 
> Jeremias Maerki

David Crossley <crossleyapache.org> wrote on
11/20/2006 09:28:49 PM:

> Jeremias Maerki wrote:
> > The DocBook stylesheets don't seem to be in SVN,
no. I have a local
> > install and when I adjust the path in
src/documentation/sitemap.xmap, 
it
> > works for me.
> 
> I think that Norm recently tweaked the build system so
that
> it doesn't need Forrest to build that Resolver article
document
> when building the resolver distribution.
> See java/resolver.xml
> 
> However it still needs the person running the build to
install
> the DocBook XSL on their local system.

That's precisely what I did and it worked.

> See notes in the build file.
> Too big to add in to our SVN for such a limited use.

<snip/>

Michael Glavassevich
XML Parser Development
IBM Toronto Lab
E-mail: mrglavasca.ibm.com
E-mail: mrglavasapache.org

/ Michael Glavassevich <mrglavasca.ibm.com> was heard to
say:
| I tried doing a complete build of the resolver
distribution yesterday and 
| got the following errors:

Sorry for the delay.

| htmldocs:
|      [echo] Building docs for xml-commons-resolver ...
|      [java] (Location of error unknown)XSLT Error 
| (javax.xml.transform.TransformerConfigurationException): 
| javax.xml.transform.TransformerException:
java.io.FileNotFoundException: 
| C:eclipse3.2.0eclipseworkspacedocbookhtmldocbook.xsl
(The system 
| cannot find the path specified)

Hmm. Don't know where that came from. Using

  http://docbook.sf.net/release/xsl/current/html/docbook
.xsl

should work.

| Obviously I'm missing docbook.xsl, though I can't seem to
find it in SVN. 
| There's a comment within the 'htmldocs' target which says:
"Note: The docs 
| are built in two ways until we stabilise the doc
generation. Both ways 
| have system-specific pathnames, so both may bust on your
system." Has 
| anyone managed to build the HTML docs successfully?

Odd. I don't remember writing that comment either.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh
XML Standards Architect
Sun Microsystems, Inc.

Hi Norm,

Norman Walsh <ndwnwalsh.com> wrote on 11/22/2006
06:56:47 AM:

> / Michael Glavassevich <mrglavasca.ibm.com> was heard to say:
> | I tried doing a complete build of the resolver
distribution yesterday 
and 
> | got the following errors:
> 
> Sorry for the delay.

That's okay. I managed to figured it out with some tips from
Jeremias. 
Thanks for looking at this though.
 
> | htmldocs:
> |      [echo] Building docs for xml-commons-resolver
...
> |      [java] (Location of error unknown)XSLT Error 
> |
(javax.xml.transform.TransformerConfigurationException): 
> | javax.xml.transform.TransformerException: 
java.io.FileNotFoundException: 
> |
C:eclipse3.2.0eclipseworkspacedocbookhtmldocbook.xsl
(The system 

> | cannot find the path specified)
> 
> Hmm. Don't know where that came from. Using
> 
>   http://docbook.sf.net/release/xsl/current/html/docbook
.xsl
> 
> should work.
> 
> | Obviously I'm missing docbook.xsl, though I can't
seem to find it in 
SVN. 
> | There's a comment within the 'htmldocs' target which
says: "Note: The 
docs 
> | are built in two ways until we stabilise the doc
generation. Both ways 

> | have system-specific pathnames, so both may bust on
your system." Has 
> | anyone managed to build the HTML docs successfully?
> 
> Odd. I don't remember writing that comment either.
> 
>                                         Be seeing you,
>                                           norm
> 
> -- 
> Norman Walsh
> XML Standards Architect
> Sun Microsystems, Inc.

Michael Glavassevich
XML Parser Development
IBM Toronto Lab
E-mail: mrglavasca.ibm.com
E-mail: mrglavasapache.org