Re: [PATCH 00/28] Enable gtk-doc

[Richard Purdie <richard.purdie@linuxfoundation.org>]

On Mon, 2016-09-05 at 08:58 +0200, Anders Darander wrote:
> * Alexander Kanavin <alexander.kanavin@linux.intel.com> [160902
> 17:08]:
> 
> > 
> > On 09/02/2016 12:59 AM, Randy MacLeod wrote:
> > > 
> > > > 
> > > > Gtk-doc generation happens if 'api-documentation' distro
> > > > feature is
> > > > enabled
> > > > (it is by default), and 'qemu-usermode' is in machine features.
> > 
> > > 
> > > Should this really be enabled by default?
> > > What does it do to a typical build wrt time and space?
> > 
> > The default distro feature list also includes all of the available
> > communication stacks, full x11 stack, pulseaudio etc. It seems to
> > me that
> > the aim is to enable as many various features as possible by
> > default.
> > Distros can and should trim the list to their specific needs.
> Sure, but as far as I remember, doc building is disabled in most
> cases.
> And personally, I'd prefer to have the doc-generation disabled per
> default. (As usually, most people I've met, won't use the doc's built
> here anyway).

There is a fairly big performance hit to enabling gtk-doc. We've
adjusted the patchset so when disabled, there isn't much of a
performance hit and I've merged things with the default being "off" for
now. We can then work through the other details and see if there is
anything we can do about the performance.

This is one of the reasons the patch series has taken a while to merge
and there were a number of issues trying to make the M3 build work and
pass testing (see the weekly status reports).

Cheers,

Richard