Can't build doc anymore (v1.7.3.2)

Can't build doc anymore (v1.7.3.2)

[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'

Could anybody tell me what's now wrong ?

Thanks
-- 
Francis

Re: Can't build doc anymore (v1.7.3.2)

[Drew Northup]

On Mon, 2010-11-22 at 20:45 +0100, Francis Moreau wrote:
> 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 ?

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. Putting those files in the local cache and fixing the
appropriate configuration file quiets the errors.

-- 
-Drew Northup N1XIM
   AKA RvnPhnx on OPN
________________________________________________
"As opposed to vegetable or mineral error?"
-John Pescatore, SANS NewsBites Vol. 12 Num. 59

Re: Can't build doc anymore (v1.7.3.2)

[Francis Moreau]

Drew Northup <drew.northup@maine.edu> writes:

> On Mon, 2010-11-22 at 20:45 +0100, Francis Moreau wrote:
>> 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 ?
>
> 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.

> 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'.

-- 
Francis

Re: Can't build doc anymore (v1.7.3.2)

[Drew Northup]

On Mon, 2010-11-22 at 21:44 +0100, Francis Moreau wrote:
> Drew Northup <drew.northup@maine.edu> writes:
> 
> > On Mon, 2010-11-22 at 20:45 +0100, Francis Moreau wrote:
> >> 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 ?
> >
> > 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.
> 
> > 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 N1XIM
   AKA RvnPhnx on OPN
________________________________________________
"As opposed to vegetable or mineral error?"
-John Pescatore, SANS NewsBites Vol. 12 Num. 59

Re: Can't build doc anymore (v1.7.3.2)

[Francis Moreau]

Drew Northup <drew.northup@maine.edu> writes:

[...]

> 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

Re: Can't build doc anymore (v1.7.3.2)

[Michael J Gruber]

Francis Moreau venit, vidit, dixit 23.11.2010 08:50:
> Drew Northup <drew.northup@maine.edu> writes:
> 
> [...]
> 
>> 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
> 

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

Re: Can't build doc anymore (v1.7.3.2)

[Francis Moreau]

Michael J Gruber <git@drmicha.warpmail.net> writes:

> Francis Moreau venit, vidit, dixit 23.11.2010 08:50:
>> Drew Northup <drew.northup@maine.edu> writes:
>> 
>> [...]
>
>> 
>>> 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
>> 
>
> 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.

>
> ASCIIDOC8=y
> ASCIIDOC_NO_ROFF=y
> DOCBOOK2X_TEXI=db2x_docbook2texi

I tried with these options but still fails

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

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

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

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

Thanks
-- 
Francis

Re: Can't build doc anymore (v1.7.3.2)

[Michael J Gruber]

Francis Moreau venit, vidit, dixit 23.11.2010 10:05:
> Michael J Gruber <git@drmicha.warpmail.net> writes:
> 
>> Francis Moreau venit, vidit, dixit 23.11.2010 08:50:
>>> Drew Northup <drew.northup@maine.edu> writes:
>>>
>>> [...]
>>
>>>
>>>> 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
>>>
>>
>> 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.
> 
>>
>> ASCIIDOC8=y
>> ASCIIDOC_NO_ROFF=y
>> DOCBOOK2X_TEXI=db2x_docbook2texi
> 
> I tried with these options but still fails
> 
>>
>> 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)
> 
>   $ type -a xmlto
>   xmlto is /usr/bin/xmlto
> 
>   $ rpm -qf /usr/bin/xmlto
>   xmlto-0.0.23-3.fc13.x86_64
> 
>> 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

Re: Can't build doc anymore (v1.7.3.2)

[Francis Moreau]

Michael J Gruber <git@drmicha.warpmail.net> writes:

[...]

>
> That's what they all say ;)
>

But they were all drunk ;)

>
> 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


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

Yes I am.

> 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?
>

No, I'm not building as root.

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

Yes I know but I wanted to report just in case there's something wrong
in the git doc build process.

Thanks
-- 
Francis

Re: Can't build doc anymore (v1.7.3.2)

[Michael J Gruber]

Francis Moreau venit, vidit, dixit 23.11.2010 10:32:
> Michael J Gruber <git@drmicha.warpmail.net> writes:
> 
> [...]
> 
>>
>> That's what they all say ;)
>>
> 
> But they were all drunk ;)
> 
>>
>> 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

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?

Michael

Re: Can't build doc anymore (v1.7.3.2)

[Francis Moreau]

Michael J Gruber <git@drmicha.warpmail.net> writes:

> Francis Moreau venit, vidit, dixit 23.11.2010 10:32:
>> 
>>   $ 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?

Yes I can.

>
> 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

> 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


Thanks for your time.
-- 
Francis

Re: Can't build doc anymore (v1.7.3.2)

[Michael J Gruber]

Francis Moreau venit, vidit, dixit 23.11.2010 12:24:
> Michael J Gruber <git@drmicha.warpmail.net> writes:
> 
>> Francis Moreau venit, vidit, dixit 23.11.2010 10:32:
>>>
>>>   $ 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?
> 
> Yes I can.
> 
>>
>> 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
> 
>> 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
> 

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

Michael

Re: Can't build doc anymore (v1.7.3.2)

[Francis Moreau]

Michael J Gruber <git@drmicha.warpmail.net> writes:

> Francis Moreau venit, vidit, dixit 23.11.2010 12:24:
>> Michael J Gruber <git@drmicha.warpmail.net> writes:
>> 
>>> Francis Moreau venit, vidit, dixit 23.11.2010 10:32:
>
>>>>
>>>>   $ 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?
>> 
>> Yes I can.
>> 
>>>
>>> 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
>> 
>>> 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
>> 
>
> I'm pretty stomped then. The only remaining suggestions:
>
> - remove xml-commons-resolver and try again
> - try as a different user

still fails.

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

-- 
Francis

Re: Can't build doc anymore (v1.7.3.2)

[Michael J Gruber]

Francis Moreau venit, vidit, dixit 23.11.2010 12:57:
> Michael J Gruber <git@drmicha.warpmail.net> writes:
> 
>> Francis Moreau venit, vidit, dixit 23.11.2010 12:24:
>>> Michael J Gruber <git@drmicha.warpmail.net> writes:
>>>
>>>> Francis Moreau venit, vidit, dixit 23.11.2010 10:32:
>>
>>>>>
>>>>>   $ 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?
>>>
>>> Yes I can.
>>>
>>>>
>>>> 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
>>>
>>>> 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
>>>
>>
>> I'm pretty stomped then. The only remaining suggestions:
>>
>> - remove xml-commons-resolver and try again
>> - try as a different user
> 
> still fails.
> 
>>
>> 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...
> 

Sometimes I hate myself for not being able to let go when all
explanations fail. OTOH it comes with my profession...

The stat looks weird but is ok. The difference is what happens then,
after opening the catalog. On my F14:


stat("http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl",
0x7fff633cb2b0) = -1 ENOENT (No such file or directory)
stat("http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl",
0x7fff633cb1f0) = -1 ENOENT (No such file or directory)
stat("/etc/xml/catalog", {st_mode=S_IFREG|0644, st_size=1829, ...}) = 0
open("/etc/xml/catalog", O_RDONLY)      = 3
lseek(3, 0, SEEK_CUR)                   = 0
read(3, "<?xml version=\"1.0\"?>\n<!DOCTYPE "..., 8192) = 1829
read(3, "", 6363)                       = 0
close(3)                                = 0
stat("/usr/share/sgml/docbook/xsl-stylesheets-1.75.2/manpages/docbook.xsl",
{st_mode=S_IFREG|0644, st_size=15170, ...}) = 0
stat("/usr/share/sgml/docbook/xsl-stylesheets-1.75.2/manpages/docbook.xsl",
{st_mode=S_IFREG|0644, st_size=15170, ...}) = 0
stat("/usr/share/sgml/docbook/xsl-stylesheets-1.75.2/manpages/docbook.xsl",
{st_mode=S_IFREG|0644, st_size=15170, ...}) = 0
open("/usr/share/sgml/docbook/xsl-stylesheets-1.75.2/manpages/docbook.xsl",
O_RDONLY) = 3

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>

(Sorry for the line-breaks)

Michael

Re: Can't build doc anymore (v1.7.3.2)

[Francis Moreau]

Michael J Gruber <git@drmicha.warpmail.net> writes:

[...]

> etc., and all is well. My /etc/xml/catalog:

Mine is different or rather incomplete.

> <?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"/>

Until this point both catalog are identical, but mine stop here...

>   <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>

All this bit is missing.

I tried to reinstall xml-common, but /etc/xml/catalog is still the same
(the shortest version)...

Could you send me your catalog file ?

Thanks
-- 
Francis

Re: Can't build doc anymore (v1.7.3.2)

[Drew Northup]

On Tue, 2010-11-23 at 09:45 +0100, Michael J Gruber wrote:
> Francis Moreau venit, vidit, dixit 23.11.2010 08:50:
> > Drew Northup <drew.northup@maine.edu> writes:
> > 
> > [...]
> > 
> >> 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.


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

> > 
> > 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
> > 
> 
> 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

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.

-- 
-Drew Northup N1XIM
   AKA RvnPhnx on OPN
________________________________________________
"As opposed to vegetable or mineral error?"
-John Pescatore, SANS NewsBites Vol. 12 Num. 59

Re: Can't build doc anymore (v1.7.3.2)

[Michael J Gruber]

Drew Northup venit, vidit, dixit 23.11.2010 14:13:
> 
> On Tue, 2010-11-23 at 09:45 +0100, Michael J Gruber wrote:
>> Francis Moreau venit, vidit, dixit 23.11.2010 08:50:
>>> Drew Northup <drew.northup@maine.edu> writes:
>>>
>>> [...]
>>>
>>>> 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.
> 
> 
>>> 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.
> 
>>>
>>> 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
>>>
>>
>> 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
> 
> 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

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

> 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

Re: Can't build doc anymore (v1.7.3.2)

[Francis Moreau]

Michael J Gruber <git@drmicha.warpmail.net> writes:

[...]

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

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

-- 
Francis

Re: Can't build doc anymore (v1.7.3.2)

[Drew Northup]

On Tue, 2010-11-23 at 17:36 +0100, Francis Moreau wrote:
> Michael J Gruber <git@drmicha.warpmail.net> writes:
> 
> [...]
> 
> >> 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.
> 
> >> 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.

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

-- 
-Drew Northup N1XIM
   AKA RvnPhnx on OPN
________________________________________________
"As opposed to vegetable or mineral error?"
-John Pescatore, SANS NewsBites Vol. 12 Num. 59

Re: Can't build doc anymore (v1.7.3.2)

[Francis Moreau]

Drew Northup <drew.northup@maine.edu> writes:

> On Tue, 2010-11-23 at 17:36 +0100, Francis Moreau wrote:
>> Michael J Gruber <git@drmicha.warpmail.net> writes:
>> 
>> [...]
>
>> 
>> >> 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.
>> 
>> >> 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.
>
> 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 ;)

Thanks both of you for your help.
-- 
Francis

Re: Can't build doc anymore (v1.7.3.2)

[Junio C Hamano]

Francis Moreau <francis.moro@gmail.com> writes:

> 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

Re: Can't build doc anymore (v1.7.3.2)

[git]

Junio C Hamano venit, vidit, dixit 24.11.2010 20:17:
> Francis Moreau <francis.moro@gmail.com> writes:
> 
>> 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

I've marked it NEXTRELEASE now since the fix is in the F10 package (the
report was against rawhide leading up to F10).

In that bug, the catalog ended up being empty for certain reasons, and
that effect has been fixed.

Here, it ended up being broken (half-written it seems), so it's similar
but different.

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.

Michael

Re: Can't build doc anymore (v1.7.3.2)

[Francis Moreau]

git@drmicha.warpmail.net writes:

[...]

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

Yes, I'll do.

-- 
Francis

Re: Can't build doc anymore (v1.7.3.2)

[Francis Moreau]

Drew Northup <drew.northup@maine.edu> writes:

> On Tue, 2010-11-23 at 09:45 +0100, Michael J Gruber wrote:
>> Francis Moreau venit, vidit, dixit 23.11.2010 08:50:
>> > Drew Northup <drew.northup@maine.edu> writes:
>> > 
>
>> > [...]
>> > 
>> >> 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?

yes it is.

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

ah that may explain why mine is incomplete.

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

Could you give me the message-id ?

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

Ok I'll try.

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

Well that wasn't obvious for me that the catalog was not complete. I
also hope that I haven't blamed anyone so far for the trouble I'm
having...

-- 
Francis

Re: Can't build doc anymore (v1.7.3.2)

[Pascal Obry]

Francis,

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

-- 

--|------------------------------------------------------
--| Pascal Obry                           Team-Ada Member
--| 45, rue Gabriel Peri - 78114 Magny Les Hameaux FRANCE
--|------------------------------------------------------
--|    http://www.obry.net  -  http://v2p.fr.eu.org
--| "The best way to travel is by means of imagination"
--|
--| gpg --keyserver keys.gnupg.net --recv-key F949BD3B

Re: Can't build doc anymore (v1.7.3.2)

[Francis Moreau]

Hello Pascal,

Pascal Obry <pascal@obry.net> writes:

[...]

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

Thanks for the tip but I tried to add in '/etc/xml/catalog' in a couple
of places but it still fails.

Well I guess I'll have to do some researches later.

Thanks
-- 
Francis