[Pkg-samba-maint] Bug#512843: smb.conf.5: warning: `/configure' not defined

[Steve Langasek]

On Sun, Jan 25, 2009 at 07:07:27AM +0100, Christian Perrier wrote:
> Quoting Steve Langasek (vorlon at debian.org):
> > On Sat, Jan 24, 2009 at 01:52:25PM +0100, Christian Perrier wrote:
> > > The attached patch fixes this though it is still a crude way to fix the
> > > problem. Moreover, that problem should be fixed in the original XML files.

> > Needs to be fixed in the XML->man translation, actually.  There's nothing
> > incorrect in the original XML file.

> THis is indeed something I'm not entirely happy with, right now:
> upstream provides "compiled" documentation along with the XML
> source. It would be nice to be able to recreate the documentation from
> the XML source.

> Here, the bug in the XML->man translation is in the tools used by
> upstream, which we have no direct control on.

We certainly could rebuild the manpages as part of the package build, but
I'm not sure that would be a win over what we have now:  my impression so
far has been that picking your xslt version means picking which set of bugs
you're willing to live with, so regenerating the docs at build time probably
just means we would have to patch the resulting autogenerated files to work
around other bugs as they become known.  Doesn't seem worth the effort, to
me.

-- 
Steve Langasek                   Give me a lever long enough and a Free OS
Debian Developer                   to set it on, and I can move the world.
Ubuntu Developer                                    http://www.debian.org/
slangasek at ubuntu.com                                     vorlon at debian.org