Issues building docs on an offline box again.

Issues building docs on an offline box again.

[Tim Visher]

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. :)

-- 

In Christ,

Timmy V.

http://burningones.com/
http://five.sentenc.es/ - Spend less time on e-mail

Re: Issues building docs on an offline box again.

[Miklos Vajna]

[-- Attachment #1: Type: text/plain, Size: 1185 bytes --]

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

Probably you somehow broke your docbook toolchain.

> 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. :)

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. :)

[-- Attachment #2: Type: application/pgp-signature, Size: 197 bytes --]

Re: Issues building docs on an offline box again.

[Tim Visher]

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

>> 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. :)
>
> That's just a workaround.

Certainly agree with you there.

> 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. :)

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!

-- 

In Christ,

Timmy V.

http://burningones.com/
http://five.sentenc.es/ - Spend less time on e-mail

Re: Issues building docs on an offline box again.

[Miklos Vajna]

[-- Attachment #1: Type: text/plain, Size: 1386 bytes --]

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

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. :)

[-- Attachment #2: Type: application/pgp-signature, Size: 197 bytes --]

Re: Issues building docs on an offline box again.

[Ben Walton]

[-- Attachment #1: Type: text/plain, Size: 1497 bytes --]

Excerpts from Miklos Vajna's message of Tue Feb 24 09:07:47 -0500 2009:
> 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.

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
-- 
Ben Walton
Systems Programmer - CHASS
University of Toronto
C:416.407.5610 | W:416.978.4302

GPG Key Id: 8E89F6D2; Key Server: pgp.mit.edu
Contact me to arrange for a CAcert assurance meeting.

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 189 bytes --]