• Bug#838447: gtk+3.0: Please build documentation packages in binary-inde

    From John Paul Adrian Glaubitz@21:1/5 to All on Wed Sep 21 12:10:01 2016
    XPost: linux.debian.bugs.dist, linux.debian.ports.68k

    Source: gtk+3.0
    Version: 3.22.0-1
    Severity: normal

    Hi!

    Currently, src:gtk+3.0 builds its documentation on all architectures which
    is rather sub-optimal as this particular step in the build process is rather time-consuming due to the fact that large XML files are parsed.

    Additionally, the binary invoked, gtkdoc-mkhtml, also causes trouble when building src:gtk+3.0 on architectures like m68k where we are using qemu:

    cd html && gtkdoc-mkhtml $mkhtml_options "--path=\"/build/gtk+3.0-TswWzT/gtk+3.0-3.22.0/./docs/reference/gtk:/build/gtk+3.0-TswWzT/gtk+3.0-3.22.0/./examples\"" gtk3 ../gtk-docs.sgml
    Makefile:549: recipe for target 'all-recursive' failed
    make[3]: *** [all-recursive] Terminated
    Makefile:1370: recipe for target 'html-build.stamp' failed
    make[5]: *** [html-build.stamp] Terminated
    Makefile:547: recipe for target 'all-recursive' failed
    make[4]: *** [all-recursive] Terminated
    /usr/share/cdbs/1/class/makefile.mk:77: recipe for target 'debian/stamp-makefile-build/shared' failed
    make: *** [debian/stamp-makefile-build/shared] Terminated
    E: Caught signal ‘Terminated’: terminating immediately
    Makefile:722: recipe for target 'all-recursive' failed
    make[2]: *** [all-recursive] Terminated
    Makefile:616: recipe for target 'all' failed
    make[1]: *** [all] Terminated
    E: Build killed with signal TERM after 60 minutes of inactivity

    In order to get src:gtk+3.0 build on the affected architectures, I usually
    edit the debian/rules file and disable the documentation by adding the configure option '--disable-gtk-doc' to DEB_CONFIGURE_FLAGS_shared.

    It would therefore be a good idea to build the documentation in the binary-indep
    target in debian/rules only. This way, we would avoid issues like the one
    above in the future and we also save quite a lot of build time on the
    slower buildds.

    Thanks for considering!

    Adrian

    --
    .''`. John Paul Adrian Glaubitz
    : :' : Debian Developer - glaubitz@debian.org
    `. `' Freie Universitaet Berlin - glaubitz@physik.fu-berlin.de
    `- GPG: 62FF 8A75 84E0 2956 9546 0006 7426 3B37 F5B5 F913

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