docs: Building with Makefile

[Andrew Bartlett]

On Sat, 2018-01-06 at 15:53 +1300, Andrew Bartlett via samba-technical
wrote:
> 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).  

That is, it is invoked during 'waf dist'.

> 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