[PATCH] Change smb.conf.5 build to use XML entities to get always-correct default paths

[Andrew Bartlett]

On Thu, 2014-01-30 at 21:53 +1300, Andrew Bartlett wrote:
> On Thu, 2014-01-30 at 06:54 +0100, Christian PERRIER wrote:
> > Quoting Andrew Bartlett (abartlet at samba.org):
> > > This patch set, inspired by the desire to check all parameter defaults
> > > in an improved docs.py test, makes the defaults in our 'man smb.conf'
> > > always correct for paths.
> > > 
> > > Because the defaults for some parameters depend on configure options,
> > > this provides these options to the XML generation by the means of XML
> > > entities - the CPP macros of the XML world. 
> > > 
> > > Because XInclude only works for full, compliant XML documents, we also
> > > have to change the code to manually concatenate the per-parameter XML
> > > documents into one big parameters.all.xml. 
> > > 
> > > This means that no matter what --prefix you put to configure, the
> > > smb.conf manpage will list the correct defaults for your platform.  This
> > > will also avoid distributions needing to patch the docs to correct the
> > > paths. 
> > 
> > 
> > That would be a great great improvement because of that last
> > consequence, definitely. Thanks a lot, Andrew, for this proposal.
> 
> I couldn't find a patch to do that in the current packaging (perhaps
> lost with the 4.0 package), but indeed, I was thinking of Debian in
> particular when I decided this was worth the effort.

Now the patches are in master, perhaps you would like to backport them
to the 4.0 and 4.1 debian packages?  It would probably 'just work', this
stuff hasn't changed a lot in recent times.

Andrew Bartlett

-- 
Andrew Bartlett                       http://samba.org/~abartlet/
Authentication Developer, Samba Team  http://samba.org
Samba Developer, Catalyst IT          http://catalyst.net.nz/services/samba