Documentation build with waf

Luk Claes luk at debian.org
Fri May 17 07:19:44 MDT 2013


Hi

Currently one can build the documentation the autoconf way and at least
the manpages with waf (but only when building regular source too). It
would probably be better if it were possible to use the waf build to
generate the documentation that's needed (like defined in
release-scripts) without the need to build anything else.

This would require new documentation targets in the waf build if I'm not
mistaken? It would also mean that not only manpages, but also html would
be created in the waf build. How can one do that?

Another thing that would make maintaining the documentation easier is
not having to specify each individual manpage (or html) in the wscript
file. Is that possible?

A last request would be that one could require the build to fail when
the documentation is not build instead of silently not building the
documentation as now is the case. How can one reach that goal? Maybe
that's trivial when using separate targets?

Cheers

Luk


More information about the samba-technical mailing list