Can't build doc anymore (v1.7.3.2)

Hello,

I'm trying to build the git's documentation, but after pulling v1.7.3.2, it fails:

  $ make prefix=/usr/local doc
  make -C Documentation all
  make[1]: Entering directory `/home/fmoreau/git/Documentation'
  make[2]: Entering directory `/home/fmoreau/git'
  make[2]: `GIT-VERSION-FILE' is up to date.
  make[2]: Leaving directory `/home/fmoreau/git'
      XMLTO git-fetch.1
  xmlto: /home/fmoreau/git/Documentation/git-fetch.xml does not validate (status 3)
  xmlto: Fix document syntax or use --skip-validation option
  I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
  /home/fmoreau/git/Documentation/git-fetch.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
                                                                                 ^
  I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
  warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  validity error : Could not load the external subset "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  Document /home/fmoreau/git/Documentation/git-fetch.xml does not validate
  make[1]: *** [git-fetch.1] Error 13
  make[1]: Leaving directory `/home/fmoreau/git/Documentation'

Could anybody tell me what's now wrong ?

Quoted 26 lines · Francis Moreau

Hello,

I'm trying to build the git's documentation, but after pulling v1.7.3.2,

it fails:

  $ make prefix=/usr/local doc
  make -C Documentation all
  make[1]: Entering directory `/home/fmoreau/git/Documentation'
  make[2]: Entering directory `/home/fmoreau/git'
  make[2]: `GIT-VERSION-FILE' is up to date.
  make[2]: Leaving directory `/home/fmoreau/git'
      XMLTO git-fetch.1
  xmlto: /home/fmoreau/git/Documentation/git-fetch.xml does not validate (status 3)
  xmlto: Fix document syntax or use --skip-validation option
  I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
  /home/fmoreau/git/Documentation/git-fetch.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
                                                                                 ^
  I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
  warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  validity error : Could not load the external subset "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  Document /home/fmoreau/git/Documentation/git-fetch.xml does not validate
  make[1]: *** [git-fetch.1] Error 13
  make[1]: Leaving directory `/home/fmoreau/git/Documentation'

Quoted 1 line

Could anybody tell me what's now wrong ?

Without more information, not specifically. However, the fix may be fairly simple.

Some distributions are apparently so ancient that they don't include the version 4.5 and newer Docbook XML XSL & DTD files. RHEL 5 and older make this list.

Quoted 27 lines · Drew Northup

Quoted 26 lines · Francis Moreau

Hello,

I'm trying to build the git's documentation, but after pulling v1.7.3.2,

it fails:

  $ make prefix=/usr/local doc
  make -C Documentation all
  make[1]: Entering directory `/home/fmoreau/git/Documentation'
  make[2]: Entering directory `/home/fmoreau/git'
  make[2]: `GIT-VERSION-FILE' is up to date.
  make[2]: Leaving directory `/home/fmoreau/git'
      XMLTO git-fetch.1
  xmlto: /home/fmoreau/git/Documentation/git-fetch.xml does not validate (status 3)
  xmlto: Fix document syntax or use --skip-validation option
  I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
  /home/fmoreau/git/Documentation/git-fetch.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
                                                                                 ^
  I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
  warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  validity error : Could not load the external subset "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  Document /home/fmoreau/git/Documentation/git-fetch.xml does not validate
  make[1]: *** [git-fetch.1] Error 13
  make[1]: Leaving directory `/home/fmoreau/git/Documentation'

Quoted 4 lines

Quoted 1 line

Could anybody tell me what's now wrong ?

Without more information, not specifically. However, the fix may be fairly simple.

What do you need exactly ?

Sorry but I know nothing about these documentation generation tools.

Quoted 3 lines

Some distributions are apparently so ancient that they don't include the version 4.5 and newer Docbook XML XSL & DTD files. RHEL 5 and older make this list.

Well I'm running Fedora 14, which I wouldn't call 'ancient'.

Supposedly docbook-dtds-1.0-53.fc14 contains the files needed. I would check to make sure that your /usr/share/sgml/docbook/xmlcatalog file is correct. If it is it will contain a line an awful lot like the following:
<public publicId="-//OASIS//DTD DocBook XML V4.5//EN" uri="xml-dtd-4.5/docbookx.dtd"/>

Drew Northup <[email protected]> writes:

[...]

Quoted 5 lines

Supposedly docbook-dtds-1.0-53.fc14 contains the files needed. I would check to make sure that your /usr/share/sgml/docbook/xmlcatalog file is correct. If it is it will contain a line an awful lot like the following:
<public publicId="-//OASIS//DTD DocBook XML V4.5//EN" uri="xml-dtd-4.5/docbookx.dtd"/>

It doesn't seem so:

  $ cat /usr/share/sgml/docbook/xmlcatalog
  <?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"/>

This file belongs to xml-common-0.6.3-33.fc14.noarch which sounds pretty uptodate for a Fedora distribution.

Here's a list of some packages installed on my system that might be relevant:

asciidoc-8.4.5-5.fc14.noarch
docbook-utils-0.6.14-26.fc14.noarch
docbook-style-xsl-1.75.2-6.fc14.noarch
docbook-style-dsssl-1.79-11.fc14.noarch
docbook-dtds-1.0-53.fc14.noarch
xml-commons-resolver-1.2-4.fc14.noarch
xmlto-0.0.23-3.fc13.x86_64
xmltex-20020625-16.fc13.noarch
libxml2-devel-2.7.7-2.fc14.x86_64
libxml2-python-2.7.7-2.fc14.x86_64
libxml++-2.30.1-1.fc14.x86_64
libxml2-2.7.7-2.fc14.i686
libxml++-2.30.1-1.fc14.i686
xml-common-0.6.3-33.fc14.noarch
xml-commons-apis-1.4.01-1.fc13.noarch

Francis Moreau venit, vidit, dixit 23.11.2010 08:50:

Quoted 16 lines

Drew Northup <[email protected]> writes:

[...]

Quoted 5 lines

Supposedly docbook-dtds-1.0-53.fc14 contains the files needed. I would check to make sure that your /usr/share/sgml/docbook/xmlcatalog file is correct. If it is it will contain a line an awful lot like the following:
<public publicId="-//OASIS//DTD DocBook XML V4.5//EN" uri="xml-dtd-4.5/docbookx.dtd"/>

It doesn't seem so:

  $ cat /usr/share/sgml/docbook/xmlcatalog
  <?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"/>

Quoted 2 lines

This file belongs to xml-common-0.6.3-33.fc14.noarch which sounds pretty uptodate for a Fedora distribution.

Quoted 4 lines

Here's a list of some packages installed on my system that might be relevant:

Quoted 16 lines

asciidoc-8.4.5-5.fc14.noarch
docbook-utils-0.6.14-26.fc14.noarch
docbook-style-xsl-1.75.2-6.fc14.noarch
docbook-style-dsssl-1.79-11.fc14.noarch
docbook-dtds-1.0-53.fc14.noarch
xml-commons-resolver-1.2-4.fc14.noarch
xmlto-0.0.23-3.fc13.x86_64
xmltex-20020625-16.fc13.noarch
libxml2-devel-2.7.7-2.fc14.x86_64
libxml2-python-2.7.7-2.fc14.x86_64
libxml++-2.30.1-1.fc14.x86_64
libxml2-2.7.7-2.fc14.i686
libxml++-2.30.1-1.fc14.i686
xml-common-0.6.3-33.fc14.noarch
xml-commons-apis-1.4.01-1.fc13.noarch

I have no problems building the doc on F14 with

ASCIIDOC8=y
ASCIIDOC_NO_ROFF=y
DOCBOOK2X_TEXI=db2x_docbook2texi

in my config.mak (besides other stuff), with these versions:

asciidoc-8.4.5-5.fc14.noarch
docbook2X-0.8.8-7.fc14.x86_64
docbook-dtds-1.0-53.fc14.noarch
docbook-style-dsssl-1.79-11.fc14.noarch
docbook-style-xsl-1.75.2-6.fc14.noarch
docbook-utils-0.6.14-26.fc14.noarch
libxml2-2.7.7-2.fc14.x86_64
libxml++-2.32.0-1.fc14.x86_64
libxml2-python-2.7.7-2.fc14.x86_64
python-lxml-2.2.8-1.fc14.x86_64
xml-common-0.6.3-33.fc14.noarch
xmlto-0.0.23-3.fc13.x86_64

(libxml is irrelevant)

Are you sure you have no other xmlto (type -a xmlto) and no tinkering with the default style sheet config?

Michael

Quoted 17 lines

Francis Moreau venit, vidit, dixit 23.11.2010 08:50:

Quoted 16 lines

Drew Northup <[email protected]> writes:

[...]

Quoted 5 lines

Supposedly docbook-dtds-1.0-53.fc14 contains the files needed. I would check to make sure that your /usr/share/sgml/docbook/xmlcatalog file is correct. If it is it will contain a line an awful lot like the following:
<public publicId="-//OASIS//DTD DocBook XML V4.5//EN" uri="xml-dtd-4.5/docbookx.dtd"/>

It doesn't seem so:

  $ cat /usr/share/sgml/docbook/xmlcatalog
  <?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"/>

Ok, before we get too far down the rabbit hole, is that EVERYTHING in your xmlcatalog? If it is then you have an install error (I downloaded the spec file and read it extra closely just to be sure). In FC14 the xmlcatalog file is not provided as whole cloth but it is built by the post-install script. If that script failed to run to completion you will have missing parts to your docbook-dtds package installation.

Quoted 2 lines

Quoted 2 lines

This file belongs to xml-common-0.6.3-33.fc14.noarch which sounds pretty uptodate for a Fedora distribution.

Yes, it is the latest in the FC git repo collection for that package as well.

Quoted 42 lines

Quoted 4 lines

Here's a list of some packages installed on my system that might be relevant:

Quoted 16 lines

asciidoc-8.4.5-5.fc14.noarch
docbook-utils-0.6.14-26.fc14.noarch
docbook-style-xsl-1.75.2-6.fc14.noarch
docbook-style-dsssl-1.79-11.fc14.noarch
docbook-dtds-1.0-53.fc14.noarch
xml-commons-resolver-1.2-4.fc14.noarch
xmlto-0.0.23-3.fc13.x86_64
xmltex-20020625-16.fc13.noarch
libxml2-devel-2.7.7-2.fc14.x86_64
libxml2-python-2.7.7-2.fc14.x86_64
libxml++-2.30.1-1.fc14.x86_64
libxml2-2.7.7-2.fc14.i686
libxml++-2.30.1-1.fc14.i686
xml-common-0.6.3-33.fc14.noarch
xml-commons-apis-1.4.01-1.fc13.noarch

I have no problems building the doc on F14 with

ASCIIDOC8=y
ASCIIDOC_NO_ROFF=y
DOCBOOK2X_TEXI=db2x_docbook2texi

in my config.mak (besides other stuff), with these versions:

asciidoc-8.4.5-5.fc14.noarch
docbook2X-0.8.8-7.fc14.x86_64
docbook-dtds-1.0-53.fc14.noarch
docbook-style-dsssl-1.79-11.fc14.noarch
docbook-style-xsl-1.75.2-6.fc14.noarch
docbook-utils-0.6.14-26.fc14.noarch
libxml2-2.7.7-2.fc14.x86_64
libxml++-2.32.0-1.fc14.x86_64
libxml2-python-2.7.7-2.fc14.x86_64
python-lxml-2.2.8-1.fc14.x86_64
xml-common-0.6.3-33.fc14.noarch
xmlto-0.0.23-3.fc13.x86_64

Quoted 6 lines

(libxml is irrelevant)

Are you sure you have no other xmlto (type -a xmlto) and no tinkering with the default style sheet config?

Michael

Before you get too much further along chasing phantoms, please have a look back into the mailing list at the problems I had just enumerated with respect to building the man pages when missing the docbook 4.5 declarations and files in my local xmlcatalog. I got EXACTLY THE SAME ERRORS ORIGINALLY NOTED. That's why I answered the original query to the list.

I recommend re-installing the docbook-dtds package alone and in isolation from other Yum/RPM transactions. If the xmlcatalog file is correctly regenerated AND the docbook files are there AND you have (re)run ./configure prior to running make AND you don't have filesystem

errors THEN you should have a successful build. (Barring something that crawls up out of the rabbit hole--other than a rabbit.)

Fix the most obvious possible problems first before seeking off-the-beaten-path solutions or worse blaming somebody.

Quoted 4 lines

I recommend re-installing the docbook-dtds package alone and in isolation from other Yum/RPM transactions. If the xmlcatalog file is correctly regenerated AND the docbook files are there AND you have (re)run ./configure prior to running make AND you don't have filesystem

Don't do that unless you're using configure for git usually. I don't think Francis is, he's setting make variables.

Quoted 6 lines

errors THEN you should have a successful build. (Barring something that crawls up out of the rabbit hole--other than a rabbit.)

Fix the most obvious possible problems first before seeking off-the-beaten-path solutions or worse blaming somebody.

???

catalog sent to Francis off-list, which closes this topic for me.

Michael J Gruber <[email protected]> writes:

[...]

Quoted 8 lines

Quoted 4 lines

I recommend re-installing the docbook-dtds package alone and in isolation from other Yum/RPM transactions. If the xmlcatalog file is correctly regenerated AND the docbook files are there AND you have (re)run ./configure prior to running make AND you don't have filesystem

Don't do that unless you're using configure for git usually. I don't think Francis is, he's setting make variables.

I won't, I just call make with some variables set.

Quoted 10 lines

Quoted 6 lines

errors THEN you should have a successful build. (Barring something that crawls up out of the rabbit hole--other than a rabbit.)

Fix the most obvious possible problems first before seeking off-the-beaten-path solutions or worse blaming somebody.

???

catalog sent to Francis off-list, which closes this topic for me.

Not really I'm afraid...

xmlto -m manpage-normal.xsl --skip-validation man git-diff-index.xml
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
/home/fmoreau/git/Documentation/git-diff-index.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"

This is with your catalog.

Quoted 34 lines · Francis Moreau

Michael J Gruber <[email protected]> writes:

[...]

Quoted 8 lines

Quoted 4 lines

I recommend re-installing the docbook-dtds package alone and in isolation from other Yum/RPM transactions. If the xmlcatalog file is correctly regenerated AND the docbook files are there AND you have (re)run ./configure prior to running make AND you don't have filesystem

Don't do that unless you're using configure for git usually. I don't think Francis is, he's setting make variables.

I won't, I just call make with some variables set.

Quoted 10 lines

Quoted 6 lines

errors THEN you should have a successful build. (Barring something that crawls up out of the rabbit hole--other than a rabbit.)

Fix the most obvious possible problems first before seeking off-the-beaten-path solutions or worse blaming somebody.

???

catalog sent to Francis off-list, which closes this topic for me.

Not really I'm afraid...

xmlto -m manpage-normal.xsl --skip-validation man git-diff-index.xml
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
/home/fmoreau/git/Documentation/git-diff-index.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"

Quoted 1 line

This is with your catalog.

I really hope you don't have any filesystem errors. May be worth checking before attempting to reinstall the docbook-dtds package.

In any case, you are apparently missing the docbook XML 4.5 DTD/XSL files (from your local cache). It automagically fails over to trying to fetch them over the internet (which I've noted doesn't work very well).

Ok, I fixed the problem by reinstalling the following packages:

- docbook-style-xsl
- docbook-dtds

I suspect something went wrong during Fedora major updates, at least that's the one I'm going to blame for now ;)

Quoted 7 lines · Francis Moreau

Ok, I fixed the problem by reinstalling the following packages:

- docbook-style-xsl
- docbook-dtds

I suspect something went wrong during Fedora major updates, at least that's the one I'm going to blame for now ;)

I vaguely recall that I saw a similar breakage due to broken xml catalog on the system when k.org updated a few years ago (not the recent move to FC13 but two updates before that one to FC9) and asked the sysadmin to reinstall docbook-dtds.

Is it still CANTFIX [*1*], I wonder?

[Reference]

*1* https://bugzilla.redhat.com/show_bug.cgi?id=454097
1

Francis: If you can reproduce this in any way then please file a Fedora bug, or describe the procedure and I'll file a bug on your behalf.

Quoted 14 lines · Michael J Gruber

Francis Moreau venit, vidit, dixit 23.11.2010 08:50:

Quoted 13 lines

Drew Northup <[email protected]> writes:

[...]

Quoted 5 lines

Supposedly docbook-dtds-1.0-53.fc14 contains the files needed. I would check to make sure that your /usr/share/sgml/docbook/xmlcatalog file is correct. If it is it will contain a line an awful lot like the following:
<public publicId="-//OASIS//DTD DocBook XML V4.5//EN" uri="xml-dtd-4.5/docbookx.dtd"/>

It doesn't seem so:

Quoted 4 lines

Quoted 4 lines

  $ cat /usr/share/sgml/docbook/xmlcatalog
  <?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"/>

Ok, before we get too far down the rabbit hole, is that EVERYTHING in your xmlcatalog?

If it is then you have an install error (I downloaded the spec file and read it extra closely just to be sure). In FC14 the xmlcatalog file is not provided as whole cloth but it is built by the post-install script. If that script failed to run to completion you will have missing parts to your docbook-dtds package installation.

Quoted 2 lines

Quoted 2 lines

This file belongs to xml-common-0.6.3-33.fc14.noarch which sounds pretty uptodate for a Fedora distribution.

Yes, it is the latest in the FC git repo collection for that package as well.

Quoted 47 lines

Quoted 4 lines

Here's a list of some packages installed on my system that might be relevant:

Quoted 16 lines

asciidoc-8.4.5-5.fc14.noarch
docbook-utils-0.6.14-26.fc14.noarch
docbook-style-xsl-1.75.2-6.fc14.noarch
docbook-style-dsssl-1.79-11.fc14.noarch
docbook-dtds-1.0-53.fc14.noarch
xml-commons-resolver-1.2-4.fc14.noarch
xmlto-0.0.23-3.fc13.x86_64
xmltex-20020625-16.fc13.noarch
libxml2-devel-2.7.7-2.fc14.x86_64
libxml2-python-2.7.7-2.fc14.x86_64
libxml++-2.30.1-1.fc14.x86_64
libxml2-2.7.7-2.fc14.i686
libxml++-2.30.1-1.fc14.i686
xml-common-0.6.3-33.fc14.noarch
xml-commons-apis-1.4.01-1.fc13.noarch

I have no problems building the doc on F14 with

ASCIIDOC8=y
ASCIIDOC_NO_ROFF=y
DOCBOOK2X_TEXI=db2x_docbook2texi

in my config.mak (besides other stuff), with these versions:

asciidoc-8.4.5-5.fc14.noarch
docbook2X-0.8.8-7.fc14.x86_64
docbook-dtds-1.0-53.fc14.noarch
docbook-style-dsssl-1.79-11.fc14.noarch
docbook-style-xsl-1.75.2-6.fc14.noarch
docbook-utils-0.6.14-26.fc14.noarch
libxml2-2.7.7-2.fc14.x86_64
libxml++-2.32.0-1.fc14.x86_64
libxml2-python-2.7.7-2.fc14.x86_64
python-lxml-2.2.8-1.fc14.x86_64
xml-common-0.6.3-33.fc14.noarch
xmlto-0.0.23-3.fc13.x86_64

(libxml is irrelevant)

Are you sure you have no other xmlto (type -a xmlto) and no tinkering with the default style sheet config?

Quoted 1 line

Michael

Before you get too much further along chasing phantoms, please have a look back into the mailing list at the problems I had just enumerated with respect to building the man pages when missing the docbook 4.5 declarations and files in my local xmlcatalog. I got EXACTLY THE SAME ERRORS ORIGINALLY NOTED. That's why I answered the original query to the list.

I recommend re-installing the docbook-dtds package alone and in isolation from other Yum/RPM transactions. If the xmlcatalog file is correctly regenerated AND the docbook files are there AND you have (re)run ./configure prior to running make AND you don't have filesystem errors THEN you should have a successful build. (Barring something that crawls up out of the rabbit hole--other than a rabbit.)

Fix the most obvious possible problems first before seeking off-the-beaten-path solutions or worse blaming somebody.

Francis Moreau venit, vidit, dixit 23.11.2010 08:50:

Quoted 24 lines

Drew Northup <[email protected]> writes:

[...]

Quoted 5 lines

Supposedly docbook-dtds-1.0-53.fc14 contains the files needed. I would check to make sure that your /usr/share/sgml/docbook/xmlcatalog file is correct. If it is it will contain a line an awful lot like the following:
<public publicId="-//OASIS//DTD DocBook XML V4.5//EN" uri="xml-dtd-4.5/docbookx.dtd"/>

It doesn't seem so:

  $ cat /usr/share/sgml/docbook/xmlcatalog
  <?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"/>

This file belongs to xml-common-0.6.3-33.fc14.noarch which sounds pretty uptodate for a Fedora distribution.

Here's a list of some packages installed on my system that might be relevant:

Quoted 16 lines

asciidoc-8.4.5-5.fc14.noarch
docbook-utils-0.6.14-26.fc14.noarch
docbook-style-xsl-1.75.2-6.fc14.noarch
docbook-style-dsssl-1.79-11.fc14.noarch
docbook-dtds-1.0-53.fc14.noarch
xml-commons-resolver-1.2-4.fc14.noarch
xmlto-0.0.23-3.fc13.x86_64
xmltex-20020625-16.fc13.noarch
libxml2-devel-2.7.7-2.fc14.x86_64
libxml2-python-2.7.7-2.fc14.x86_64
libxml++-2.30.1-1.fc14.x86_64
libxml2-2.7.7-2.fc14.i686
libxml++-2.30.1-1.fc14.i686
xml-common-0.6.3-33.fc14.noarch
xml-commons-apis-1.4.01-1.fc13.noarch

I have no problems building the doc on F14 with

ASCIIDOC8=y
ASCIIDOC_NO_ROFF=y
DOCBOOK2X_TEXI=db2x_docbook2texi

in my config.mak (besides other stuff), with these versions:

asciidoc-8.4.5-5.fc14.noarch
docbook2X-0.8.8-7.fc14.x86_64
docbook-dtds-1.0-53.fc14.noarch
docbook-style-dsssl-1.79-11.fc14.noarch
docbook-style-xsl-1.75.2-6.fc14.noarch
docbook-utils-0.6.14-26.fc14.noarch
libxml2-2.7.7-2.fc14.x86_64
libxml++-2.32.0-1.fc14.x86_64
libxml2-python-2.7.7-2.fc14.x86_64
python-lxml-2.2.8-1.fc14.x86_64
xml-common-0.6.3-33.fc14.noarch
xmlto-0.0.23-3.fc13.x86_64

(libxml is irrelevant)

Are you sure you have no other xmlto (type -a xmlto)

and no tinkering with the default style sheet config?

Quoted 42 lines · Michael J Gruber

Francis Moreau venit, vidit, dixit 23.11.2010 08:50:

Quoted 24 lines

Drew Northup <[email protected]> writes:

[...]

Quoted 5 lines

Supposedly docbook-dtds-1.0-53.fc14 contains the files needed. I would check to make sure that your /usr/share/sgml/docbook/xmlcatalog file is correct. If it is it will contain a line an awful lot like the following:
<public publicId="-//OASIS//DTD DocBook XML V4.5//EN" uri="xml-dtd-4.5/docbookx.dtd"/>

It doesn't seem so:

  $ cat /usr/share/sgml/docbook/xmlcatalog
  <?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"/>

This file belongs to xml-common-0.6.3-33.fc14.noarch which sounds pretty uptodate for a Fedora distribution.

Here's a list of some packages installed on my system that might be relevant:

Quoted 16 lines

asciidoc-8.4.5-5.fc14.noarch
docbook-utils-0.6.14-26.fc14.noarch
docbook-style-xsl-1.75.2-6.fc14.noarch
docbook-style-dsssl-1.79-11.fc14.noarch
docbook-dtds-1.0-53.fc14.noarch
xml-commons-resolver-1.2-4.fc14.noarch
xmlto-0.0.23-3.fc13.x86_64
xmltex-20020625-16.fc13.noarch
libxml2-devel-2.7.7-2.fc14.x86_64
libxml2-python-2.7.7-2.fc14.x86_64
libxml++-2.30.1-1.fc14.x86_64
libxml2-2.7.7-2.fc14.i686
libxml++-2.30.1-1.fc14.i686
xml-common-0.6.3-33.fc14.noarch
xml-commons-apis-1.4.01-1.fc13.noarch

Quoted 2 lines

I have no problems building the doc on F14 with

Yes I think it's related to my config otherwise a lot of users would have already complained.

Quoted 4 lines

ASCIIDOC8=y
ASCIIDOC_NO_ROFF=y
DOCBOOK2X_TEXI=db2x_docbook2texi

I tried with these options but still fails

Quoted 16 lines

in my config.mak (besides other stuff), with these versions:

asciidoc-8.4.5-5.fc14.noarch
docbook2X-0.8.8-7.fc14.x86_64
docbook-dtds-1.0-53.fc14.noarch
docbook-style-dsssl-1.79-11.fc14.noarch
docbook-style-xsl-1.75.2-6.fc14.noarch
docbook-utils-0.6.14-26.fc14.noarch
libxml2-2.7.7-2.fc14.x86_64
libxml++-2.32.0-1.fc14.x86_64
libxml2-python-2.7.7-2.fc14.x86_64
python-lxml-2.2.8-1.fc14.x86_64
xml-common-0.6.3-33.fc14.noarch
xmlto-0.0.23-3.fc13.x86_64

Quoted 3 lines

(libxml is irrelevant)

Are you sure you have no other xmlto (type -a xmlto)

  $ type -a xmlto
  xmlto is /usr/bin/xmlto

  $ rpm -qf /usr/bin/xmlto
  xmlto-0.0.23-3.fc13.x86_64

Quoted 1 line

and no tinkering with the default style sheet config?

Well I've never played with that since I've no idea of what it's.

That's what they all say ;)

How successful is:

make XMLTO_EXTRA="--skip-validation" doc

This should avoid hitting the network for the dtd under all circumstances. (Are you online when make'ing?)

Normally, the catalogue should take care of that but this seems to be failing for you.

Just to make sure: You're not building as root, are you?

You can also use the quick-install-doc target, of course, but we want install-doc to work as well on a mainstream distro.

Michael J Gruber <[email protected]> writes:

[...]

Quoted 3 lines

That's what they all say ;)

But they were all drunk ;)

Quoted 5 lines

How successful is:

make XMLTO_EXTRA="--skip-validation" doc

still failing:

  $ make prefix=/usr/local NO_CURL=1 ASCIIDOC8=y DOCBOOK2X_TEXI=db2x_docbook2texi ASCIIDOC_NO_ROFF=y XMLTO_EXTRA="--skip-validation" V=1 doc
  make -C Documentation all
  make[1]: Entering directory `/home/fmoreau/git/Documentation'
  make -C ../  GIT-VERSION-FILE
  make[2]: Entering directory `/home/fmoreau/git'
  make[2]: `GIT-VERSION-FILE' is up to date.
  make[2]: Leaving directory `/home/fmoreau/git'
  rm -f git-fetch.1 && \
  xmlto -m manpage-normal.xsl --skip-validation man git-fetch.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.A7kzn5 line 4 element import
  xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
  make[1]: *** [git-fetch.1] Error 1
  make[1]: Leaving directory `/home/fmoreau/git/Documentation'
  make: *** [doc] Error 2

Francis Moreau venit, vidit, dixit 23.11.2010 10:32:

Quoted 17 lines

  $ make prefix=/usr/local NO_CURL=1 ASCIIDOC8=y DOCBOOK2X_TEXI=db2x_docbook2texi ASCIIDOC_NO_ROFF=y XMLTO_EXTRA="--skip-validation" V=1 doc
  make -C Documentation all
  make[1]: Entering directory `/home/fmoreau/git/Documentation'
  make -C ../  GIT-VERSION-FILE
  make[2]: Entering directory `/home/fmoreau/git'
  make[2]: `GIT-VERSION-FILE' is up to date.
  make[2]: Leaving directory `/home/fmoreau/git'
  rm -f git-fetch.1 && \
  xmlto -m manpage-normal.xsl --skip-validation man git-fetch.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.A7kzn5 line 4 element import
  xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
  make[1]: *** [git-fetch.1] Error 1
  make[1]: Leaving directory `/home/fmoreau/git/Documentation'
  make: *** [doc] Error 2

This is weird for several reasons.

Can you wget or curl these files?

Besides, I can build the doc even without network access, even though my /tmp/xmlto... has the same import statement.

Can you check with which options your xmlto calls your xsltproc? Mine has "--nonet".

Do you have libxslt-1.1.26-3.fc14.x86_64, and is your xsltproc the one from that package?

Quoted 19 lines · Michael J Gruber

Francis Moreau venit, vidit, dixit 23.11.2010 10:32:

Quoted 17 lines

  $ make prefix=/usr/local NO_CURL=1 ASCIIDOC8=y DOCBOOK2X_TEXI=db2x_docbook2texi ASCIIDOC_NO_ROFF=y XMLTO_EXTRA="--skip-validation" V=1 doc
  make -C Documentation all
  make[1]: Entering directory `/home/fmoreau/git/Documentation'
  make -C ../  GIT-VERSION-FILE
  make[2]: Entering directory `/home/fmoreau/git'
  make[2]: `GIT-VERSION-FILE' is up to date.
  make[2]: Leaving directory `/home/fmoreau/git'
  rm -f git-fetch.1 && \
  xmlto -m manpage-normal.xsl --skip-validation man git-fetch.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.A7kzn5 line 4 element import
  xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
  make[1]: *** [git-fetch.1] Error 1
  make[1]: Leaving directory `/home/fmoreau/git/Documentation'
  make: *** [doc] Error 2

Quoted 3 lines

This is weird for several reasons.

Can you wget or curl these files?

Yes I can.

Quoted 6 lines

Besides, I can build the doc even without network access, even though my /tmp/xmlto... has the same import statement.

Can you check with which options your xmlto calls your xsltproc? Mine has "--nonet".

I can see the following ones:

--nonet
--xinclude

Quoted 2 lines

Do you have libxslt-1.1.26-3.fc14.x86_64, and is your xsltproc the one from that package?

  $ rpm -qa | grep libxslt
  libxslt-devel-1.1.26-3.fc14.x86_64
  libxslt-1.1.26-3.fc14.x86_64

  $ which xsltproc
  /usr/bin/xsltproc

  $ rpm -qf /usr/bin/xsltproc
  libxslt-1.1.26-3.fc14.x86_64

Francis Moreau venit, vidit, dixit 23.11.2010 12:24:

Quoted 50 lines

Quoted 20 lines · Michael J Gruber

Francis Moreau venit, vidit, dixit 23.11.2010 10:32:

Quoted 17 lines

  $ make prefix=/usr/local NO_CURL=1 ASCIIDOC8=y DOCBOOK2X_TEXI=db2x_docbook2texi ASCIIDOC_NO_ROFF=y XMLTO_EXTRA="--skip-validation" V=1 doc
  make -C Documentation all
  make[1]: Entering directory `/home/fmoreau/git/Documentation'
  make -C ../  GIT-VERSION-FILE
  make[2]: Entering directory `/home/fmoreau/git'
  make[2]: `GIT-VERSION-FILE' is up to date.
  make[2]: Leaving directory `/home/fmoreau/git'
  rm -f git-fetch.1 && \
  xmlto -m manpage-normal.xsl --skip-validation man git-fetch.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.A7kzn5 line 4 element import
  xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
  make[1]: *** [git-fetch.1] Error 1
  make[1]: Leaving directory `/home/fmoreau/git/Documentation'
  make: *** [doc] Error 2

Quoted 3 lines

This is weird for several reasons.

Can you wget or curl these files?

Yes I can.

Quoted 6 lines

Besides, I can build the doc even without network access, even though my /tmp/xmlto... has the same import statement.

Can you check with which options your xmlto calls your xsltproc? Mine has "--nonet".

I can see the following ones:

--nonet
--xinclude

Quoted 2 lines

Do you have libxslt-1.1.26-3.fc14.x86_64, and is your xsltproc the one from that package?

  $ rpm -qa | grep libxslt
  libxslt-devel-1.1.26-3.fc14.x86_64
  libxslt-1.1.26-3.fc14.x86_64

  $ which xsltproc
  /usr/bin/xsltproc

Quoted 3 lines

  $ rpm -qf /usr/bin/xsltproc
  libxslt-1.1.26-3.fc14.x86_64

I'm pretty stomped then. The only remaining suggestions:

- remove xml-commons-resolver and try again
- try as a different user

Otherwise, an strace of xsltproc might give some hints...

Quoted 51 lines · Michael J Gruber

Francis Moreau venit, vidit, dixit 23.11.2010 12:24:

Quoted 50 lines

Quoted 20 lines · Michael J Gruber

Francis Moreau venit, vidit, dixit 23.11.2010 10:32:

Quoted 17 lines

  $ make prefix=/usr/local NO_CURL=1 ASCIIDOC8=y DOCBOOK2X_TEXI=db2x_docbook2texi ASCIIDOC_NO_ROFF=y XMLTO_EXTRA="--skip-validation" V=1 doc
  make -C Documentation all
  make[1]: Entering directory `/home/fmoreau/git/Documentation'
  make -C ../  GIT-VERSION-FILE
  make[2]: Entering directory `/home/fmoreau/git'
  make[2]: `GIT-VERSION-FILE' is up to date.
  make[2]: Leaving directory `/home/fmoreau/git'
  rm -f git-fetch.1 && \
  xmlto -m manpage-normal.xsl --skip-validation man git-fetch.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.A7kzn5 line 4 element import
  xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
  make[1]: *** [git-fetch.1] Error 1
  make[1]: Leaving directory `/home/fmoreau/git/Documentation'
  make: *** [doc] Error 2

Quoted 3 lines

This is weird for several reasons.

Can you wget or curl these files?

Yes I can.

Quoted 6 lines

Besides, I can build the doc even without network access, even though my /tmp/xmlto... has the same import statement.

Can you check with which options your xmlto calls your xsltproc? Mine has "--nonet".

I can see the following ones:

--nonet
--xinclude

Quoted 2 lines

Do you have libxslt-1.1.26-3.fc14.x86_64, and is your xsltproc the one from that package?

  $ rpm -qa | grep libxslt
  libxslt-devel-1.1.26-3.fc14.x86_64
  libxslt-1.1.26-3.fc14.x86_64

  $ which xsltproc
  /usr/bin/xsltproc

Quoted 8 lines

Quoted 3 lines

  $ rpm -qf /usr/bin/xsltproc
  libxslt-1.1.26-3.fc14.x86_64

I'm pretty stomped then. The only remaining suggestions:

- remove xml-commons-resolver and try again
- try as a different user

still fails.

Quoted 2 lines

Otherwise, an strace of xsltproc might give some hints...

Here it is:

  stat("/tmp/xmlto-xsl.aSCQgY", {st_mode=S_IFREG|0600, st_size=346, ...}) = 0
  stat("/tmp/xmlto-xsl.aSCQgY", {st_mode=S_IFREG|0600, st_size=346, ...}) = 0
  stat("/tmp/xmlto-xsl.aSCQgY", {st_mode=S_IFREG|0600, st_size=346, ...}) = 0
  stat("/tmp/xmlto-xsl.aSCQgY", {st_mode=S_IFREG|0600, st_size=346, ...}) = 0

open("/tmp/xmlto-xsl.aSCQgY", O_RDONLY) = 3
lseek(3, 0, SEEK_CUR) = 0
read(3, "<?xml version='1.0'?>\n<xsl:style"..., 8192) = 346
read(3, "", 7846) = 0
close(3) = 0
stat("http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl", 0x7fffa8779e50) = -1 ENOENT (No such file or directory) stat("http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl", 0x7fffa8779d90) = -1 ENOENT (No such file or directory) stat("/etc/xml/catalog", {st_mode=S_IFREG|0644, st_size=819, ...}) = 0
open("/etc/xml/catalog", O_RDONLY) = 3
lseek(3, 0, SEEK_CUR) = 0
read(3, "<?xml version=\"1.0\"?>\n<!DOCTYPE "..., 8192) = 819
read(3, "", 7373) = 0
close(3) = 0
stat("http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl", 0x7fffa8779d90) = -1 ENOENT (No such file or directory)
write(2, "I/O ", 4) = 4
write(2, "error : ", 8) = 8
write(2, "Attempt to load network entity h"..., 103) = 103
write(2, "warning: ", 9) = 9
write(2, "failed to load external entity \""..., 105) = 105
write(2, "compilation error: file /tmp/xml"..., 68) = 68
write(2, "xsl:import : unable to load http"..., 100) = 100

This looks weird, it does stat(2) on an URL...

etc., and all is well. My /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">
<delegatePublic publicIdStartString="-//OASIS//ENTITIES DocBook XML"
catalog="file:///etc/sgml/docbook/xmlcatalog"/>
<delegatePublic publicIdStartString="-//OASIS//DTD DocBook XML"

catalog="file:///etc/sgml/docbook/xmlcatalog"/>
<delegatePublic publicIdStartString="ISO 8879:1986"
catalog="file:///etc/sgml/docbook/xmlcatalog"/>
<delegateSystem
systemIdStartString="http://www.oasis-open.org/docbook/" catalog="file:///etc/sgml/docbook/xmlcatalog"/>
<delegateURI uriStartString="http://www.oasis-open.org/docbook/"
catalog="file:///etc/sgml/docbook/xmlcatalog"/>

<rewriteSystem
systemIdStartString="http://scrollkeeper.sourceforge.net/dtds/scrollkeeper-omf-1.0/scrollkeeper-omf.dtd" rewritePrefix="/usr/share/xml/scrol
lkeeper/dtds/scrollkeeper-omf.dtd"/>
<rewriteURI
uriStartString="http://scrollkeeper.sourceforge.net/dtds/scrollkeeper-omf-1.0/scrollkeeper-omf.dtd" rewritePrefix="/usr/share/xml/scrollkeeper/
dtds/scrollkeeper-omf.dtd"/>
<rewriteSystem
systemIdStartString="http://docbook.sourceforge.net/release/xsl/1.75.2" rewritePrefix="file:///usr/share/sgml/docbook/xsl-stylesheets-1.75.2
"/>
<rewriteURI
uriStartString="http://docbook.sourceforge.net/release/xsl/1.75.2" rewritePrefix="file:///usr/share/sgml/docbook/xsl-stylesheets-1.75.2"/>

<rewriteSystem
systemIdStartString="http://docbook.sourceforge.net/release/xsl/current" rewritePrefix="file:///usr/share/sgml/docbook/xsl-stylesheets-1.75. 2"/>
<rewriteURI
uriStartString="http://docbook.sourceforge.net/release/xsl/current" rewritePrefix="file:///usr/share/sgml/docbook/xsl-stylesheets-1.75.2"/> </catalog>

XMLTO git-fetch.1
xmlto: /home/fmoreau/git/Documentation/git-fetch.xml does not validate (status 3)
xmlto: Fix document syntax or use --skip-validation option
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
/home/fmoreau/git/Documentation/git-fetch.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"

                                                                                 ^

I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" validity error : Could not load the external subset "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" Document /home/fmoreau/git/Documentation/git-fetch.xml does not validate
make[1]: *** [git-fetch.1] Error 13
make[1]: Leaving directory `/home/fmoreau/git/Documentation'

Could anybody tell me what's now wrong ?

I had a similar problem on Cygwin at some point. The fix was to add some rewrite rule in the docbook catalog (/etc/xml/catalog):

I had added this:

<rewriteSystem

     systemIdStartString="http://www.oasis-open.org/docbook/xml/4.5/"
     rewritePrefix="/usr/share/sgml/docbook/xml-dtd-4.4/"/>

You may have to adjust...