Opened 8 years ago

Closed 8 years ago

Last modified 8 years ago

#6436 closed defect (implemented)

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

Reported by: sjmurdoch Owned by:
Priority: Low Milestone:
Component: Core Tor/Tor Version:
Severity: Keywords: tor-relay
Cc: Actual Points:
Parent ID: Points:
Reviewer: Sponsor:


Having installed asciidoc and docbook on Mac OS X using homebrew, the asciidoc files fail to build:

Baird:doc sjm217$ make
../doc/ man /usr/local/bin/a2x ../doc/
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.

Child Tickets

Attachments (1)

0001-Clarify-how-to-build-asciidoc-files-using-homebrew-o.patch (1.0 KB) - added by sjmurdoch 8 years ago.

Download all attachments as: .zip

Change History (5)

comment:1 Changed 8 years ago by nickm

Resolution: implemented
Status: newclosed

Added a changes file and merged. Thanks!

comment:2 Changed 8 years ago by nickm

Keywords: tor-relay added

comment:3 Changed 8 years ago by nickm

Component: Tor RelayTor

comment:4 Changed 8 years ago by 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 (
  2. Start Xcode. Goto Preferences -> Downloads and install Command-line tools.
  3. Install 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://
  9. cd tor
  10. ./
  11. ./configure
  12. make
  13. make install

At this point typing tor should successfully start TOR.

Note: See TracTickets for help on using tickets.