docs: Building with Makefile

[Andrew Bartlett]

On Fri, 2018-01-05 at 21:18 +0100, Andreas Schneider via samba-
technical wrote:
> On Friday, 5 January 2018 19:56:02 CET Björn Jacke wrote:
> > The branch, master has been updated
> >        via  3cbeaf4 docs-xml: add basic Makefile dependencies for targets
> > that use xsltproc via  9b27948 docs-xml: set a reasonable XML_CATALOG_FILES
> > in Makefile via  a2f5b3b docs-xml: generate build/catalog.xml via Makefile
> > target from  2245a4b autobuild: fix quoting of --restrict-tests
> > 
> > https://git.samba.org/?p=samba.git;a=shortlog;h=master
> > 
> > 
> > - Log -----------------------------------------------------------------
> > commit 3cbeaf40937082bd7072d715ae02aa0989835432
> > Author: Björn Jacke <bjacke at samba.org>
> > Date:   Thu Jan 4 16:35:12 2018 +0100
> > 
> >     docs-xml: add basic Makefile dependencies for targets that use xsltproc
> > 
> 
> Why do you build with Makefile? Is the stuff in waf so bad?

The Makefile build is used for the in-tarball manpages that we ship
because we fear folks won't have xsltproc etc or it won't run for them
(this was an issue for a while on Debian).  

We could remove this step and see if folks really need it, or possibly
do a recursive waf invocation, but for now this is the reason.

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