Question

I am trying to install Git on Mac OS X Leopard. I’m trying to avoid the MacPorts/Fink route. I’m also trying to avoid the installer on Google because I’ve gotten very far on my own, but if I have to I’ll go ahead and download the installer.

Anyway, I have Git installed. /usr/local/bin/git. The problem is that none of the documentation installed, and the Makefile never bothered to tell me that. So now I have Git sitting around waiting to be used as I try to install the manpages for it.

For some awful reason, the manpages are maintained as text files, which are to be processed by the AsciiDoc program, which I promptly installed. But AsciiDoc converts these text files to XML.

Then Git uses another program called xmlto to convert the XML that AsciiDoc spits out to manpages (I think – I haven’t gotten that far yet). The problem is that I get this error whenever it starts that step (first line is output from make, rest is error):

    XMLTO git-apply.1
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
/Users/chrislutz/prog/sources/git-1.6.3.1/Documentation/git-apply.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"

So basically it just goes through every file and gives me that error for all of them.

I did try at one point to download the file http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd, put it in the directory, and then changed all the references in the XML files to the file in the directory, but this gave me more and stranger errors. If I got a regular solution to work, it might still give me those stranger errors, which means the whole thing is screwed and that I’ll just use the Google installer.

However, I’ve gotten (stumbled) this far on my own, and I feel like this is one last step before a sigh of relief and the chance to use Git. So I want to make a last-ditch effort to understand what’s wrong. And “last-ditch effort” means “Ask Stack Overflow.”

So if anyone could give me any insight as to what that error means and why it’s occuring (and what I might be able to do to fix it), that would be awesome. If not, I’ll try the Google installer.

Answer 1

Maybe not the answer you want, but you could just download the git-manpages-*.tar.gz and git-html-*.tar.gz that are published along with the source. They’re published because the asciidoc toolchain is known to be a bit fragile, and a considerable effort to get everything installed and arranged.

You’d need, I believe, possibly a whole pack of docbook support files. Maybe some stylesheets as well… although if you have xmlto installed you should have got all these.