[PATCH 1/8] Build documentation during build instead of dist

Vratislav Podzimek vpodzime at redhat.com
Sun Jul 27 12:40:56 UTC 2014


On Fri, 2014-07-25 at 17:08 -0400, David Shea wrote:
> Gtk-doc is the worst at autotools integration. 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.
> 
>   - It's driven through an opaque Makefile that forces docs to be built
>     at source distribution time.
> 
>   - 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.
> 
>   - ...and it doesn't set up any Makefile dependencies at all, so it
>     just fails if you forget to do a build first.
> 
>   - In fact, it's pretty crummy about keeping track of the dependencies
>     for its own generated files. If you add or remove one of the source
>     files that docs are generated from, you pretty much just have to do
>     a git clean and start over.
> 
>   - It pulls in a ton of dist-time dependencies for other docs packages
>     so that it can generate cross references but it still doesn't have
>     cross reference data for half the stuff in glib because it sucks.
> 
> Get rid of gtk-doc's automatically installed files, where most of the
> problems lie. Adapt the rules from gtk-doc.make into a single script
> that runs everything to reduce the dependency nightmare. Run the script
> at build time.
First of all big THANKS for your effort and working on this! The patch
looks good to me though I cannot say I understand it completely.

-- 
Vratislav Podzimek

Anaconda Rider | Red Hat, Inc. | Brno - Czech Republic



More information about the anaconda-patches mailing list