Problem generating PDF/TeX documentation

[Jonas Olsson]

On Sun, 30 Nov 2003, John H Terpstra wrote:

> 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 reason I looked into this is that I want to build RPM packages with
the latest SAMBA_3_0 code from CVS and in that package include the man
pages from the documentation tree. In order to do that I need to generate
a tar.gz archive with a populated docs directory which I generate from the
samba-docs CVS tree.

However, since the generation of man pages isn't affected by this bug I
have no problem accepting that the rest of the documentation is not
included in the RPMs I will be making. The generation of man pages is
essential though if you need a quick reference.

-- snip --

> 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/"/>

This however leads to that a user who downloads the samba-docs CVS tree
might have a hard time building the documentation without help from the
samba-technical list. Perhaps a small pointer on how to do this could be
included in the source?

Sincerely,

  /Jonas Olsson

>
> 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
>