Documentation build failure

[Ian Lynagh]

On Sun, Mar 06, 2011 at 01:05:12AM +0000, Ian Lynagh wrote:
> On Sat, Mar 05, 2011 at 01:20:03PM +0100, Malte Sommerkorn wrote:
> > 
> > Building the ps/pdf documentation works only with a specific, outdated
> > version of dblatex

I've just won a battle with dblatex to get the docs built on OS X. If
you're having problems then the attached may be of help.


Thanks
Ian

-------------- next part --------------

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 @@
 <xsl:param name="latex.class.article">article</xsl:param>
 <xsl:param name="latex.class.book">report</xsl:param>
 <xsl:param name="latex.unicode.use">0</xsl:param>
-<xsl:param name="texlive.version">2010</xsl:param>
+<xsl:param name="texlive.version">2009</xsl:param>

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!