[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