Asciidoc files don't build using Homebrew on Mac OS X
Having installed asciidoc and docbook on Mac OS X using homebrew, the asciidoc files fail to build:
Baird:doc sjm217$ make
../doc/asciidoc-helper.sh man /usr/local/bin/a2x ../doc/tor.1.in
a2x: ERROR: "xmllint" --nonet --noout --valid "/Users/sjm217/w/tor/doc/tor.1.xml" returned non-zero exit status 4
==================================
You need a working asciidoc installed to be able to build the manpage.
...
This appears to be because even though the docbook DTD files are installed, xmllint will not find them by default. To fix this, the XML_CATALOG_FILES
environment variable must be set to include /usr/local/etc/xml/catalog
.
The attached patch clarifies the error message.