Issues building docs on an offline box again.

Hello all,

I'm having a strange issue build the man pages again on my offline box.

I have a copy of cygwin installed on both my online and offline box with the same configuration. On my online box, the man pages build fine. On my offline box I get the following dump:

$ make install-man
rm -f doc.dep+ doc.dep
/usr/bin/perl ./build-docdep.perl >doc.dep+
mv doc.dep+ doc.dep
make -C ../ GIT-VERSION-FILE
make[1]: Entering directory `/cygdrive/c/Documents and
Settings/tvishe01/My Documents/git'
GIT_VERSION = 1.6.2.rc1.25.g2d602e
make[1]: Leaving directory `/cygdrive/c/Documents and
Settings/tvishe01/My Documents/git'
make[1]: Entering directory `/cygdrive/c/Documents and
Settings/tvishe01/My Documents/git'
make[1]: `GIT-VERSION-FILE' is up to date.
make[1]: Leaving directory `/cygdrive/c/Documents and
Settings/tvishe01/My Documents/git'
make -C ../ GIT-VERSION-FILE
make[1]: Entering directory `/cygdrive/c/Documents and
Settings/tvishe01/My Documents/git'
make[1]: `GIT-VERSION-FILE' is up to date.
make[1]: Leaving directory `/cygdrive/c/Documents and
Settings/tvishe01/My Documents/git'
rm -f git-add.xml+ git-add.xml
asciidoc -b docbook -d manpage -f asciidoc.conf \
                 -agit_version=1.6.2.rc1.25.g2d602e -o git-add.xml+ git-add.txt
mv git-add.xml+ git-add.xml
rm -f git-add.1
xmlto -m callouts.xsl man git-add.xml
I/O error : Attempt to load network entity
http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
warning: failed to load external entity
"http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"
compilation error: file /tmp/xmlto-xsl.f254nC line 4 element import
xsl:import : unable to load
http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
make: *** [git-add.1] Error 1

Strange thing is that I thought I had gotten these to build offline before with the exact same configuration. Any thoughts?

My current solution is to build them on the online box and then copy them over the sneaker net to the offline box. But, this is kludgey, so not cool. :)

On Mon, Feb 23, 2009 at 06:07:54PM -0500, Tim Visher <tim.visher@gmail.com> wrote:

Probably you somehow broke your docbook toolchain.

That's just a workaround. The solution is to have the correct mappings under /etc/xml, so that it maps the doctype to /usr/share/xml/docbook/manpages/docbook.xsl, or a similar path. After all, ideally your distro does this for you automatically. :)

On Mon, Feb 23, 2009 at 9:28 PM, Miklos Vajna <vmiklos@frugalware.org> wrote:

Certainly agree with you there.

How would I do that? Unfortunately I have no experience whatsoever with configuring docbook. I've always just used a package manager to install it. Anyway, there's a `catalog` file in /etc/xml with the following:

$ cat /etc/xml/catalog
<?xml version="1.0"?>
<!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog
V1.0//EN" "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
  <public publicId="-//OASIS//DTD DocBook XML V4.2//EN"
uri="http://www.oasis-open.org/docbook/xml/4.2/"/>
  <rewriteSystem
systemIdStartString="http://www.oasis-open.org/docbook/xml/4.2/"
rewritePrefix="/usr/share/xml/docbook/4.2/"/>
</catalog>

To my untrained eye there seems to be a local path in there but I have no idea.

Thanks for the help!

On Tue, Feb 24, 2009 at 08:04:47AM -0500, Tim Visher <tim.visher@gmail.com> wrote:

I'm not a docbook expert, either - but It seems the url your config rewrites is http://www.oasis-open.org/docbook/xml/4.2, while the url you try to access during the build is http://docbook.sourceforge.net/release/xsl/current. So I *think* you need to add two other entries as well for the xsl urls, but I'm just guessing.

If it does not work, probably it worth asking on a docbook list, where people have more clue about docbook. :)

Excerpts from Miklos Vajna's message of Tue Feb 24 09:07:47 -0500 2009:

I'm no expert either, but I just became more familiar after packaging it for OpenCSW (just to build the git docs!). It's likely that your docbook dtds are fine but the xsl stylesheets are either missing or broken.

Try looking at the docbook stylesheets (xsl in particular) packages in your cygwin setup. There should be lines like:

<rewriteSystem systemIdStartString="http://docbook.sourceforge.net/release/xsl /current" rewritePrefix="file:///usr/share/sgml/docbook/xsl-stylesheets-1.69.1-5 .1"/> <rewriteURI uriStartString="http://docbook.sourceforge.net/release/xsl/current "rewritePrefix="file:///usr/share/sgml/docbook/xsl-stylesheets-1.69.1-5.1"/>

to handle the remapping you require. This was from the /etc/xml/catalog file on rhel5, but it should be _similar_ on a cygwin setup (my cygwin boxes aren't outfitted with the docbook toolchain so I can't verify for you).

HTH. -Ben