From http://www.tug.org/mactex/ downloaded and installed http://mirror.ctan.org/systems/mac/mactex/MacTeX.mpkg.zip From http://dblatex.sourceforge.net/ downloaded and built http://prdownloads.sourceforge.net/dblatex/dblatex-0.3.tar.bz2?download Now building users_guide.pdf will fail, as we generate things like: ͱt\nolinkurl{ͰuC:\Documentsͱu}\texttt{\ }\nolin[...] rather than: ͱt\nolinkurl{ͰuC:\\Documentsͱu}\texttt{\ }\nolin[...] (note number of backslashes). To fix this, patch param.xsl: --- param.xsl 2011-03-18 18:10:23.000000000 +0000 +++ /usr/share/dblatex/xsl/param.xsl 2010-10-27 08:56:16.000000000 +0100 @@ -16,7 +16,7 @@ article report 0 -2010 +2009 This is a little odd. The Debian package has this patch applied, and on Debian: $ latex --version pdfTeX 3.1415926-1.40.10-2.2 (TeX Live 2009/Debian) [...] but on OS X: $ latex --version pdfTeX 3.1415926-1.40.11-2.2 (TeX Live 2010) [...] so it doesn't seem like it should be needed. But anyway... Now the PDF will fail to build with: makeindex: Not writing to /private/tmp/tmpw4xTzV/users_guide.ind (openout_any = p). Can't create output index file /private/tmp/tmpw4xTzV/users_guide.ind. So we put openout_any = r in /usr/local/texlive/2010/texmf.cnf And the docs will finally build!