git编译:Documentation/git-add.xml不验证

Question

编译git时我有以下错误:

make[2]: Leaving directory `/home/xxx/git-master'
    XMLTO git-add.1
xmlto: /home/xxx/git-master/Documentation/git-add.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/xxx/git-master/Documentation/git-add.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/xxx/git-master/Documentation/git-add.xml does not validate
make[1]: *** [git-add.1] Error 13
make[1]: Leaving directory `/home/xxx/git-master/Documentation'
make: *** [doc] Error 2

主要问题是什么？

Answer 1

晚到派对,但在cygwin上你需要验证的包docbook-xml45(如DTD URI暗示,docbook/xml/4.5/docbookx.dtd)

Answer 2

在OSX(Mountain Lion)我必须这样做:

brew install asciidoc
brew install xmlto
brew install docbook   

# then (as prompted by brew...)
#
# If you intend to process AsciiDoc files through an XML stage
# (such as a2x for manpage generation) you need to add something
# like:
#
export XML_CATALOG_FILES=/usr/local/etc/xml/catalog
#
# to your shell rc file so that xmllint can find AsciiDoc's
# catalog files.

brew install docbook-xsl

(感谢Nathan提供必要的提示).#6chars

Answer 3

这似乎是 git 反复出现的问题。在寻找解决方案时（今天），我在几个论坛中遇到了它。（Linux、Cygwin、Mac 操作系统）。问题总是一样的：缺乏好的文档目录。不幸的是，安装适当的目录高度依赖于您的安装，并且有不止一种方法缺乏好的目录。

1. 几年前发布了一份糟糕的目录。卸载并安装更新。
2. 构建目录的包中途失败了。删除并重新安装该软件包。
3. 安装目录的包还没有安装，打包工具还没搭理你。

选项3就是我当时的情况。我安装了brew，所以 sudo brew install docbook sudo docbook-register 帮我解决了这个问题。

或者，也可以单独下载可用的文档。