# Troubles building man pages

3 messages from 2009-09-01 to 2009-09-02. Participants: Brian S. Schang, Junio C Hamano.
Thread: https://gitlist.dev/t/20805

## Brian S. Schang, 2009-09-01 02:30

Subject: Troubles building man pages
Message-ID: <4A9C8750.60308@lists.schang.net>
URL: https://gitlist.dev/e/4A9C8750.60308%40lists.schang.net

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

> # 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, 2009-09-01 02:44

Subject: Re: Troubles building man pages
Message-ID: <7v7hwjidt2.fsf@alter.siamese.dyndns.org>
URL: https://gitlist.dev/e/7v7hwjidt2.fsf%40alter.siamese.dyndns.org
In-Reply-To: <4A9C8750.60308@lists.schang.net>

```
"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"
>
> 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, 2009-09-02 00:52

Subject: Re: Troubles building man pages
Message-ID: <4A9DC1B4.8060000@lists.schang.net>
URL: https://gitlist.dev/e/4A9DC1B4.8060000%40lists.schang.net
In-Reply-To: <7v7hwjidt2.fsf@alter.siamese.dyndns.org>

```
Junio (et al):

Junio C Hamano wrote:
> "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

```
