valadoc is normally used to build developer-oriented API documentation
in an Architecture: all package, in this case libzeitgeist-2.0-doc. 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 zeitgeist
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 zeitgeist'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 := ...
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.
If I'm reading packages.debian.org correctly, libzeitgeist-2.0-doc
seems to be essentially empty - is this actually working as intended,
or is the documentation broken/useless already? If it isn't useful then
perhaps it could just be dropped.
Thanks,
smcv