Source: zeitgeist
Version: 1.0.4-5
Severity: wishlist

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

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)