blob: 8c925633db2e2d897597f36c30c7014b508e12a3 [file] [log] [blame]
Brad Bishop1a4b7ee2018-12-16 17:11:34 -08001SUMMARY = "Documentation generator for glib-based software"
2DESCRIPTION = "Gtk-doc is a set of scripts that extract specially formatted comments \
3 from glib-based software and produce a set of html documentation files from them"
Andrew Geissler6ce62a22020-11-30 19:58:47 -06004HOMEPAGE = "https://www.gtk.org/docs/"
Brad Bishop1a4b7ee2018-12-16 17:11:34 -08005LICENSE = "GPLv2"
6LIC_FILES_CHKSUM = "file://COPYING;md5=94d55d512a9ba36caa9b7df079bae19f"
7
8inherit gnomebase
9
10# Configure the scripts correctly (and build their dependencies) only if they are actually
11# going to be used; otheriwse we need only the m4/makefile includes from the gtk-doc tarball.
12PACKAGECONFIG ??= "${@bb.utils.contains("DISTRO_FEATURES", "api-documentation", "working-scripts", "", d)}"
13
14# This will cause target gtk-doc to hardcode paths of native dependencies
15# into its scripts. This means that target gtk-doc package is broken;
16# hopefully no one minds because its scripts are not used for anything during build
17# and shouldn't be used on targets.
Brad Bishop15ae2502019-06-18 21:44:24 -040018PACKAGECONFIG[working-scripts] = ",,libxslt-native xmlto-native python3-six python3-pygments"
Brad Bishop1a4b7ee2018-12-16 17:11:34 -080019PACKAGECONFIG[tests] = "--enable-tests,--disable-tests,glib-2.0"
20
Andrew Geisslerd1e89492021-02-12 15:35:20 -060021SRC_URI[archive.sha256sum] = "cc1b709a20eb030a278a1f9842a362e00402b7f834ae1df4c1998a723152bf43"
Brad Bishop1a4b7ee2018-12-16 17:11:34 -080022SRC_URI += "file://0001-Do-not-hardocode-paths-to-perl-python-in-scripts.patch \
23 file://0001-Do-not-error-out-if-xsltproc-is-not-found.patch \
24 file://conditionaltests.patch \
25 file://no-clobber.patch \
Brad Bishop1a4b7ee2018-12-16 17:11:34 -080026 "
27SRC_URI_append_class-native = " file://pkg-config-native.patch"
28
29BBCLASSEXTEND = "native nativesdk"
30
31# Do not check for XML catalogs when building because that
32# information is not used for anything during build. Recipe
33# dependencies make sure we have all the right bits.
34do_configure_prepend() {
35 sed -i -e 's,^JH_CHECK_XML_CATALOG.*,,' ${S}/configure.ac
36}
37
Andrew Geissler82c905d2020-04-13 13:39:40 -050038do_install_append () {
39 # configure values for python3 and pkg-config encoded in scripts
40 for fn in ${bindir}/gtkdoc-depscan \
41 ${bindir}/gtkdoc-mkhtml2 \
Andrew Geissler4ed12e12020-06-05 18:00:41 -050042 ${datadir}/gtk-doc/python/gtkdoc/config.py; do
Andrew Geissler82c905d2020-04-13 13:39:40 -050043 sed -e 's,${RECIPE_SYSROOT_NATIVE}/usr/bin/pkg-config,${bindir}/pkg-config,' \
44 -e 's,${HOSTTOOLS_DIR}/python3,${bindir}/python3,' \
45 -i ${D}$fn
46 done
47}
48
Brad Bishop1a4b7ee2018-12-16 17:11:34 -080049FILES_${PN} += "${datadir}/sgml"
50FILES_${PN}-dev += "${libdir}/cmake"
51FILES_${PN}-doc = ""
52
53SYSROOT_PREPROCESS_FUNCS_append_class-native = " gtkdoc_makefiles_sysroot_preprocess"
54gtkdoc_makefiles_sysroot_preprocess() {
55 # Patch the gtk-doc makefiles so that the qemu wrapper is used to run transient binaries
56 # instead of libtool wrapper or running them directly
57 sed -i \
58 -e "s|GTKDOC_RUN =.*|GTKDOC_RUN = \$(top_builddir)/gtkdoc-qemuwrapper|" \
59 ${SYSROOT_DESTDIR}${datadir}/gtk-doc/data/gtk-doc*make
60}