threads / discuss / 20805

Troubles building man pages

Subject: Troubles building man pages

## tl;dr

3 messages between Sep 1, 2009 and Sep 2, 2009.

replies: 2people: 2as markdown or json

Brian S. Schang· Sep 1, 2009, 02:30 UTC · lore

Hello:

I am having problem building the man pages for git v1.6.4.2. I am getting the follow stream of errors: (sorry for the long lines)

Show 24 quoted lines

> # make ASCIIDOC8=Yes man
> GIT_VERSION = 1.6.4.2
> make -C Documentation man
> make[1]: Entering directory `/raida/packages/git/Documentation'
>     GEN doc.dep
> make[2]: Entering directory `/raida/packages/git'
> make[2]: `GIT-VERSION-FILE' is up to date.
> make[2]: Leaving directory `/raida/packages/git'
> make[1]: Leaving directory `/raida/packages/git/Documentation'
> make[1]: Entering directory `/raida/packages/git/Documentation'
> make[2]: Entering directory `/raida/packages/git'
> make[2]: `GIT-VERSION-FILE' is up to date.
> make[2]: Leaving directory `/raida/packages/git'
>     ASCIIDOC git-add.xml
>     XMLTO git-add.1
> I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd
> /raida/packages/git/Documentation/git-add.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
> D DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
>                                                                                ^
>     ASCIIDOC git-am.xml
>     XMLTO git-am.1
> I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd
> /raida/packages/git/Documentation/git-am.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
> D DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"

I have read through INSTALL and Documentation/README. I have tried to cover all dependencies, but I suspect that I'm missing something simple.

Note that 'git' itself compiles fine and I can build the HTML pages fine also. It seems to be the man pages that cause the problem.

Note that I am using openSUSE 11.1. I was able to build the man pages on my older openSUSE 11.0 machine, but not any longer.

I would appreciate any advice you are willing to share.

Thank you.

-- 
Brian Schang

Junio C Hamano· Sep 1, 2009, 02:44 UTC · re: Brian S. Schang · lore

Re: Troubles building man pages

"Brian S. Schang" <git@lists.schang.net> writes:

Show 15 quoted lines

>>     ASCIIDOC git-am.xml
>>     XMLTO git-am.1
>> I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd
>> /raida/packages/git/Documentation/git-am.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
>> D DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
>
> I have read through INSTALL and Documentation/README. I have tried to
> cover all dependencies, but I suspect that I'm missing something
> simple.
>
> Note that 'git' itself compiles fine and I can build the HTML pages
> fine also. It seems to be the man pages that cause the problem.
>
> Note that I am using openSUSE 11.1. I was able to build the man pages
> on my older openSUSE 11.0 machine, but not any longer.

The following was an ancient experience of mine with a different distro but I am reasonably sure it would point you in the right direction.

    http://article.gmane.org/gmane.comp.version-control.git/107387

Brian S. Schang· Sep 2, 2009, 00:52 UTC · re: Junio C Hamano · lore

Re: Troubles building man pages

Junio (et al):

Junio C Hamano wrote:

Show 7 quoted lines

> "Brian S. Schang" <git@lists.schang.net> writes:
> 
>>>     ASCIIDOC git-am.xml
>>>     XMLTO git-am.1
>>> I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd
>>> /raida/packages/git/Documentation/git-am.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
>>> D DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"

> The following was an ancient experience of mine with a different distro
> but I am reasonably sure it would point you in the right direction.
> 
>     http://article.gmane.org/gmane.comp.version-control.git/107387

Thank you! The link you sent suggested a reinstall of DocBook. I tried that and magically everything started to work fine.

I appreciate the help.

-- 
Brian Schang