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

Christian PERRIER bubulle at debian.org
Wed Jan 29 22:54:40 MST 2014

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.

More information about the samba-technical mailing list