Building Documentation in Cygwin

From: Tim Visher <tim.visher@gmail.com>
Date: Jan 27, 2009, 15:41 UTC
Message-ID: <c115fd3c0901270741h2f213b99s31bac8829bd182c2@mail.gmail.com>

Hey Everyone,

I've asked this question here before but unfortunately I can't find the answer in any of the archives. I'm trying to build the documentation on Windows in Cygwin. Git builds fine, the html docs build fine, but when I get to the man pages, I get the following error:

    $ make install-man
    rm -f doc.dep+ doc.dep
    /usr/bin/perl ./build-docdep.perl >doc.dep+
    mv doc.dep+ doc.dep
    make -C ../ GIT-VERSION-FILE
    make[1]: Entering directory `/cygdrive/c/Documents and
Settings/tvishe01/Desktop/Projects/git'
    make[1]: `GIT-VERSION-FILE' is up to date.
    make[1]: Leaving directory `/cygdrive/c/Documents and
Settings/tvishe01/Desktop/Projects/git'
    make -C ../ GIT-VERSION-FILE
    make[1]: Entering directory `/cygdrive/c/Documents and
Settings/tvishe01/Desktop/Projects/git'
    make[1]: `GIT-VERSION-FILE' is up to date.
    make[1]: Leaving directory `/cygdrive/c/Documents and
Settings/tvishe01/Desktop/Projects/git'
    rm -f git-add.xml+ git-add.xml
    asciidoc -b docbook -d manpage -f asciidoc.conf \
                     -agit_version=1.6.1.1.230.gdfb04 -o git-add.xml+
git-add.txt
    mv git-add.xml+ git-add.xml
    rm -f git-add.1
    xmlto -m callouts.xsl man git-add.xml
    xmlto: input does not validate (status 3)
    error : Operation not permitted
    /home/tvishe01/projects/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"

            ^
    error : Operation not permitted
    warning: failed to load external entity
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
    Could not load the external subset
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
    Document /home/tvishe01/projects/git/Documentation/git-add.xml
does not validate
    make: *** [git-add.1] Error 3

I've fixed this before but I've been thwarted all morning on the Googles trying to find out what to do. I remember it having something to do with explicitly telling xmlto not to try to download doctypes or something. Also, I remember there being pre-built man pages somewhere that I could download and just manually install.

Anyway, I'm not opposed to either of those routes, I just can't figure out how to do it personally.

Thanks in advance!

--

http://five.sentenc.es/ - Spend less time on e-mail. Written using [Emacs](http://www.gnu.org/software/emacs/).