Problem generating PDF/TeX documentation

[John H Terpstra]

Jonas,

Thanks for the feedback. Is there really any need to build the
documentation outside of the daily update on all Samba.Org Web servers?

The documentation tree will change considerable in March 2004 when the
sources for "The Official Samba-3 HOWTO and Reference Guide" will be
committed to public CVS. There are 5 chapters that are in the book and
not in the Samba-HOWTO-Collection. Additionally, all the stylesheets for
the book will become part of the HOWTO code base. Things are really a lot
different in the build system for the book.

We did make a decision to not include the db2latex stuff in CVS and to
accept the limitations of this. The toolset needed to build the book
without errors is not insignificant.

Also, a better way to deal with the change your patch makes is to install
the db2latex xsl info into the same tree used for sgml on your platform,
then in your XML catalog add the path substitution entry.

Mine is as follows:

<rewriteURI uriStartString="http://db2latex.sourceforge.net/xsl/"
rewritePrefix="/usr/share/sgml/db2latex/xsl/"/>

PS: We do use pd2latex version 0.70 at this time.

Cheers,
John T.


On Sat, 29 Nov 2003, Jonas Olsson wrote:

> Hello,
>
> After checking out the latest samba-docs from the cvs archive I get errors
> when attempting to generate the PDF version of the documentation.
>
> The reason is the reference to
> "http://db2latex.sourceforge.net/xsl/docbook.xsl" in
> /cvsroot/samba-docs/docbook/xslt/latex.xsl. That URL no longer seems to
> exist which leads to numerous errors when xsltproc tries to generate the
> TeX documentation.
>
> "make pdf" works when using the latest DB2LaTeX distribution unpacked
> in samba-docs/docbook/xslt/db2latex with the following patch applied
> to latex.xsl:
>
> ---- snip -----
>
> Index: latex.xsl
> ===================================================================
> RCS file: /cvsroot/samba-docs/docbook/xslt/latex.xsl,v
> retrieving revision 1.6
> diff -u -r1.6 latex.xsl
> --- latex.xsl   18 Nov 2003 18:07:11 -0000      1.6
> +++ latex.xsl   29 Nov 2003 22:35:14 -0000
> @@ -1,6 +1,6 @@
>  <?xml version="1.0" encoding="ISO-8859-1"?>
>  <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version='1.0'>
> -<xsl:import href="http://db2latex.sourceforge.net/xsl/docbook.xsl"/>
> +<xsl:import href="db2latex/xsl/docbook.xsl"/>
>
>  <xsl:output method="text" encoding="ISO-8859-1" indent="yes"/>
>  <xsl:param name="l10n.gentext.default.language">en</xsl:param>
>
> ---- snip -----
>
> DB2LaTeX would need to be included in the samba-docs tree as well but I
> hesitate to include that as a patch :-). I haven't been able to find any
> reference to an online version of docbook.xsl at the DB2LaTeX site.
>
>   /Jonas Olsson
>

-- 
John H Terpstra
Email: jht at samba.org