Asciidoc files don't build using Homebrew on Mac OS X

[sjmurdoch]

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.

[nickm]

Added a changes file and merged. Thanks!

[hiddentao]

Thanks for this. These are the steps I took to getting the latest Git version of TOR compiling on OS X 10.8.2 Mountain Lion.

1. Install Xcode (​https://developer.apple.com/technologies/tools/)
2. Start Xcode. Goto Preferences -> Downloads and install Command-line tools.
3. Install Homebrew (​http://mxcl.github.com/homebrew/)
4. Ensure /usr/local/bin is write-able by brew, you could do chown <user>:<group> /usr/local/bin.
5. brew install autoconf automake libevent asciidoc
6. Ensure the build can make use of asciidoc properly: export XML_CATALOG_FILES="/usr/local/etc/xml/catalog"
7. Ensure the next shell we open has asciidoc already setup: echo export XML_CATALOG_FILES="/usr/local/etc/xml/catalog" >> ~/.bashrc
8. git clone git://git.torproject.org/git/tor
9. cd tor
10. ./autogen.sh
11. ./configure
12. make
13. make install

At this point typing tor should successfully start TOR.