[PATCH] Change smb.conf.5 build to use XML entities to get always-correct default paths
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
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