[PATCH 00/28] Enable gtk-doc

Alexander Kanavin
2016-08-26T14:30:22Z

This patchset adds gtk-doc support to OE-core. It requires running
transient binaries during build time, which is achieved via qemu,
and so there are all the same caveats as with gobject-introspection.

Gtk-doc generation happens if 'api-documentation' distro feature is enabled
(it is by default), and 'qemu-usermode' is in machine features. Disable
the former if api documentation is not needed in your distro; disable the latter
if qemu does not work correctly for your target machine.

Gtk-doc support is a part of a broader task to enable API documentation
support in OE-core; later on I will add support for doxygen and docbook, enable
more manpages, and clean up the legacy SGML stack if possible.

The following changes since commit a81b326933d15f08e06780f92d8dc0d4efb3cd23:

combo-layer: python3: fix UnicodeDecodeError (2016-08-24 13:58:28 +0100)

are available in the git repository at:

git://git.yoctoproject.org/poky-contrib akanavin/enable-documentation
http://git.yoctoproject.org/cgit.cgi/poky-contrib/log/?h=akanavin/enable-documentation

Alexander Kanavin (28):
source-highlight: add a recipe
gtk-doc: add a recipe, remove gtk-doc-stub
bitbake.conf: add "api-documentation" to default distro features
gtk-doc.bbclass: enable building gtk-doc based documentation
kmod: do not let gtkdocize fail
systemd: drop unused gtkdoc-related variable
libglade: remove the recipe
gstreamer1.0: enable gtk-doc support
webkitgtk: enable gtk-doc support
gcr: disable gtk-doc on x86_64
gcr, libsecret, webkitgtk: disable gtk-doc on mips64
webkitgtk: re-enable introspection on powerpc
dbus-glib: enable gtk-doc
orc: enable gtk-doc
libidn: enable gtk-doc
libuser: enable gtk-doc
gdk-pixbuf: enable gtk-doc
gnome-desktop3: enable gtk-doc
json-glib: enable gtk-doc
libgudev: enable gtk-doc
libenck3: enable gtk-doc
cairo: enable gtk-doc
harfbuzz: enable gtk-doc
gnutls: enable gtk-doc
libtasn1: enable gtk-doc
libsoup-2.4: enable gtk-doc
p11-kit: enable gtk-doc
util-linux: do not enable gtk-doc and explain why

meta/classes/gtk-doc.bbclass | 72 ++-
meta/conf/bitbake.conf | 2 +-
meta/conf/distro/include/security_flags.inc | 1 +
meta/recipes-core/dbus/dbus-glib.inc | 2 +-
meta/recipes-core/systemd/systemd_230.bb | 2 -
meta/recipes-core/util-linux/util-linux.inc | 1 +
meta/recipes-devtools/orc/orc_0.4.25.bb | 2 +-
meta/recipes-extended/libidn/libidn_1.33.bb | 2 +-
meta/recipes-extended/libuser/libuser_0.62.bb | 2 +-
meta/recipes-gnome/gcr/gcr_3.20.0.bb | 4 +-
meta/recipes-gnome/gdk-pixbuf/gdk-pixbuf_2.34.0.bb | 2 +-
.../gnome-desktop/gnome-desktop3_3.20.2.bb | 2 +-
...t-Import-introspection-stub-machinery-too.patch | 305 -------------
.../recipes-gnome/gtk-doc-stub/gtk-doc-stub_git.bb | 33 --
meta/recipes-gnome/gtk-doc/gtk-doc_1.25.bb | 37 ++
meta/recipes-gnome/json-glib/json-glib_1.2.2.bb | 2 +-
.../libglade/libglade-2.6.4/glade-cruft.patch | 102 -----
.../libglade/libglade-2.6.4/no-xml2.patch | 501 ---------------------
.../libglade-2.6.4/python_environment.patch | 14 -
meta/recipes-gnome/libglade/libglade_2.6.4.bb | 31 --
meta/recipes-gnome/libgudev/libgudev_230.bb | 2 +-
meta/recipes-gnome/libsecret/libsecret_0.18.5.bb | 2 +-
meta/recipes-gnome/libwnck/libwnck3_3.20.1.bb | 2 +-
meta/recipes-graphics/cairo/cairo.inc | 2 +-
meta/recipes-graphics/harfbuzz/harfbuzz_1.3.0.bb | 2 +-
meta/recipes-kernel/kmod/kmod.inc | 2 +-
.../gstreamer/gstreamer1.0-libav.inc | 2 +-
.../gstreamer/gstreamer1.0-omx.inc | 2 +-
.../gstreamer/gstreamer1.0-plugins.inc | 14 +-
.../gstreamer/gstreamer1.0-rtsp-server.inc | 14 +-
meta/recipes-multimedia/gstreamer/gstreamer1.0.inc | 16 +-
...c-settings-so-that-gtkdoc-generation-work.patch | 49 ++
meta/recipes-sato/webkit/webkitgtk_2.12.3.bb | 13 +-
meta/recipes-support/gnutls/gnutls.inc | 4 +-
meta/recipes-support/gnutls/libtasn1_4.9.bb | 2 +-
meta/recipes-support/libsoup/libsoup-2.4_2.54.1.bb | 2 +-
meta/recipes-support/p11-kit/p11-kit_0.22.1.bb | 22 +-
...light.pc.in-do-not-add-Boost-s-libraries-.patch | 30 ++
.../source-highlight/source-highlight_3.1.8.bb | 28 ++
39 files changed, 287 insertions(+), 1042 deletions(-)
delete mode 100644 meta/recipes-gnome/gtk-doc-stub/files/0001-Revert-Import-introspection-stub-machinery-too.patch
delete mode 100644 meta/recipes-gnome/gtk-doc-stub/gtk-doc-stub_git.bb
create mode 100644 meta/recipes-gnome/gtk-doc/gtk-doc_1.25.bb
delete mode 100644 meta/recipes-gnome/libglade/libglade-2.6.4/glade-cruft.patch
delete mode 100644 meta/recipes-gnome/libglade/libglade-2.6.4/no-xml2.patch
delete mode 100644 meta/recipes-gnome/libglade/libglade-2.6.4/python_environment.patch
delete mode 100644 meta/recipes-gnome/libglade/libglade_2.6.4.bb
create mode 100644 meta/recipes-sato/webkit/files/0001-Tweak-gtkdoc-settings-so-that-gtkdoc-generation-work.patch
create mode 100644 meta/recipes-support/source-highlight/files/0001-source-highlight.pc.in-do-not-add-Boost-s-libraries-.patch
create mode 100644 meta/recipes-support/source-highlight/source-highlight_3.1.8.bb

--
2.9.3