Source: plank
Version: 0.11.89-4.1
Severity: wishlist

valadoc is normally used to build developer-oriented API documentation
in an Architecture: all package, in this case libplank-dev. It has
non-trivial dependencies that are part of a cycle, so we had to disable
it during the 64-bit time_t transition, which means plank has not been
recompiled for that transition on armel/armhf until now (although I've
just uploaded a version of vala with valadoc restored).

It would simplify cross-compiling, builds on new architectures and big
transitions like this one if plank's API documentation was only built
during Architecture: all builds, similar to what happens for the gtk-doc
or gi-docgen API documentation in GLib and GTK. That change would require
something like this in debian/rules (untested):

---------------------------------------------------------------------------
built_binaries := $(shell dh_listpackages)

configure_options := --enable-headless-tests

ifneq ($(filter %-doc,$(built_binaries)),)
configure_options += --enable-docs
else
configure_options += --disable-docs
endif

override_dh_auto_configure:
        dh_auto_configure -- $(configure_options)
---------------------------------------------------------------------------

This would also make the build on each architecture quicker.

Thanks,
    smcv

Reply via email to