[master 1/8] Dump gtk-doc.

Colin Walters walters at verbum.org
Thu Jul 24 20:12:12 UTC 2014


On Thu, Jul 24, 2014, at 03:32 PM, David Shea wrote:
> Gtk-doc is the worst. Allow me to enumerate:
> 
>   - It adds an option to our autoconf script that causes everything to
>     fail if it is disabled. It is disabled by default.

You can use m4_ifdef to avoid a hard dependency on it.

For example:
https://git.gnome.org/browse/glib/tree/configure.ac#n2576

>   - It's driven through an opaque Makefile that forces docs to be built
>     at source distribution time.

FWIW I avoid this by just using "git archive" to generate tarballs.  If
anyone pursues this path in the future (say, for continuous delivery
where you don't want to download data from some external webservice that
might or might not be up), using Source1 in the RPM seems like it'd
work.
 
>   - It requires the library to be built before it can generate docs, so
>     it requires a full build before a source tarball can be created.

Yeah, but this also not an issue with "git archive".  That's how I deal
with it, and that's also how Continuous works.

> Also no one reads the docs, probably. 

That however is probably true =)


More information about the anaconda-patches mailing list