1 # Copyright 1999-2016 Gentoo Foundation
2 # Distributed under the terms of the GNU General Public License v2
5 # @ECLASS: kde4-base.eclass
8 # @BLURB: This eclass provides functions for kde 4.X ebuilds
10 # The kde4-base.eclass provides support for building KDE4 based ebuilds
11 # and KDE4 applications.
13 # NOTE: KDE 4 ebuilds currently support EAPI 5. This will be
14 # reviewed over time as new EAPI versions are approved.
16 if [[ -z ${_KDE4_BASE_ECLASS} ]]; then
19 # @ECLASS-VARIABLE: KDE_SELINUX_MODULE
21 # If set to "none", do nothing.
22 # For any other value, add selinux to IUSE, and depending on that useflag
23 # add a dependency on sec-policy/selinux-${KDE_SELINUX_MODULE} to (R)DEPEND
24 : ${KDE_SELINUX_MODULE:=none}
26 # @ECLASS-VARIABLE: VIRTUALDBUS_TEST
28 # If defined, launch and use a private dbus session during src_test.
30 # @ECLASS-VARIABLE: VIRTUALX_REQUIRED
32 # For proper description see virtualx.eclass manpage.
33 # Here we redefine default value to be manual, if your package needs virtualx
34 # for tests you should proceed with setting VIRTUALX_REQUIRED=test.
35 : ${VIRTUALX_REQUIRED:=manual}
37 inherit kde4-functions toolchain-funcs fdo-mime flag-o-matic gnome2-utils virtualx versionator eutils multilib
39 if [[ ${KDE_BUILD_TYPE} = live ]]; then
41 svn) inherit subversion ;;
42 git) inherit git-r3 ;;
46 # @ECLASS-VARIABLE: CMAKE_REQUIRED
48 # Specify if cmake buildsystem is being used. Possible values are 'always' and 'never'.
49 # Please note that if it's set to 'never' you need to explicitly override following phases:
50 # src_configure, src_compile, src_test and src_install.
51 # Defaults to 'always'.
52 : ${CMAKE_REQUIRED:=always}
53 if [[ ${CMAKE_REQUIRED} = always ]]; then
54 buildsystem_eclass="cmake-utils"
55 export_fns="src_configure src_compile src_test src_install"
58 # @ECLASS-VARIABLE: KDE_MINIMAL
60 # This variable is used when KDE_REQUIRED is set, to specify required KDE minimal
61 # version for apps to work. Currently defaults to 4.4
62 # One may override this variable to raise version requirements.
63 # Note that it is fixed to ${PV} for kde-base packages.
64 KDE_MINIMAL="${KDE_MINIMAL:-4.4}"
66 # Set slot for KDEBASE known packages
69 SLOT=4/$(get_version_component_range 1-2)
73 if [[ ${KDE_BUILD_TYPE} = live ]]; then
74 # @ECLASS-VARIABLE: KDEVELOP_VERSION
76 # Specifies KDevelop version. Default is 4.0.0 for tagged packages and 9999 for live packages.
77 # Applies to KDEBASE=kdevelop only.
78 KDEVELOP_VERSION="${KDEVELOP_VERSION:-4.9999}"
79 # @ECLASS-VARIABLE: KDEVPLATFORM_VERSION
81 # Specifies KDevplatform version. Default is 1.0.0 for tagged packages and 9999 for live packages.
82 # Applies to KDEBASE=kdevelop only.
83 KDEVPLATFORM_VERSION="${KDEVPLATFORM_VERSION:-4.9999}"
87 KDEVELOP_VERSION=${PV}
88 KDEVPLATFORM_VERSION="$(($(get_major_version)-3)).$(get_after_major_version)"
90 kdevplatform|kdevelop-php*|kdevelop-python)
91 KDEVELOP_VERSION="$(($(get_major_version)+3)).$(get_after_major_version)"
92 KDEVPLATFORM_VERSION=${PV}
95 KDEVELOP_VERSION="${KDEVELOP_VERSION:-4.0.0}"
96 KDEVPLATFORM_VERSION="${KDEVPLATFORM_VERSION:-1.0.0}"
103 inherit ${buildsystem_eclass}
105 EXPORT_FUNCTIONS pkg_setup src_unpack src_prepare ${export_fns} pkg_preinst pkg_postinst pkg_postrm
107 unset buildsystem_eclass
110 # @ECLASS-VARIABLE: DECLARATIVE_REQUIRED
112 # Is qtdeclarative required? Possible values are 'always', 'optional' and 'never'.
113 # This variable must be set before inheriting any eclasses. Defaults to 'never'.
114 DECLARATIVE_REQUIRED="${DECLARATIVE_REQUIRED:-never}"
116 # @ECLASS-VARIABLE: QTHELP_REQUIRED
118 # Is qthelp required? Possible values are 'always', 'optional' and 'never'.
119 # This variable must be set before inheriting any eclasses. Defaults to 'never'.
120 QTHELP_REQUIRED="${QTHELP_REQUIRED:-never}"
122 # @ECLASS-VARIABLE: OPENGL_REQUIRED
124 # Is qtopengl required? Possible values are 'always', 'optional' and 'never'.
125 # This variable must be set before inheriting any eclasses. Defaults to 'never'.
126 OPENGL_REQUIRED="${OPENGL_REQUIRED:-never}"
128 # @ECLASS-VARIABLE: MULTIMEDIA_REQUIRED
130 # Is qtmultimedia required? Possible values are 'always', 'optional' and 'never'.
131 # This variable must be set before inheriting any eclasses. Defaults to 'never'.
132 MULTIMEDIA_REQUIRED="${MULTIMEDIA_REQUIRED:-never}"
134 # @ECLASS-VARIABLE: WEBKIT_REQUIRED
136 # Is qtwebkit required? Possible values are 'always', 'optional' and 'never'.
137 # This variable must be set before inheriting any eclasses. Defaults to 'never'.
138 WEBKIT_REQUIRED="${WEBKIT_REQUIRED:-never}"
140 # @ECLASS-VARIABLE: CPPUNIT_REQUIRED
142 # Is cppunit required for tests? Possible values are 'always', 'optional' and 'never'.
143 # This variable must be set before inheriting any eclasses. Defaults to 'never'.
144 CPPUNIT_REQUIRED="${CPPUNIT_REQUIRED:-never}"
146 # @ECLASS-VARIABLE: KDE_REQUIRED
148 # Is kde required? Possible values are 'always', 'optional' and 'never'.
149 # This variable must be set before inheriting any eclasses. Defaults to 'always'
150 # If set to 'always' or 'optional', KDE_MINIMAL may be overriden as well.
151 # Note that for kde-base packages this variable is fixed to 'always'.
152 KDE_REQUIRED="${KDE_REQUIRED:-always}"
154 # @ECLASS-VARIABLE: KDE_HANDBOOK
156 # Set to enable handbook in application. Possible values are 'always', 'optional'
157 # (handbook USE flag) and 'never'.
158 # This variable must be set before inheriting any eclasses. Defaults to 'never'.
159 # It adds default handbook dirs for kde-base packages to KMEXTRA and in any case it
160 # ensures buildtime and runtime dependencies.
161 KDE_HANDBOOK="${KDE_HANDBOOK:-never}"
163 # @ECLASS-VARIABLE: KDE_LINGUAS_LIVE_OVERRIDE
165 # Set this varible if you want your live package to manage its
166 # translations. (Mostly all kde ebuilds does not ship documentation
167 # and translations in live ebuilds)
168 if [[ ${KDE_BUILD_TYPE} == live && -z ${KDE_LINGUAS_LIVE_OVERRIDE} ]]; then
169 # Kdebase actually provides the handbooks even for live stuff
170 [[ ${KDEBASE} == kde-base ]] || KDE_HANDBOOK=never
174 # Setup packages inheriting this eclass
177 HOMEPAGE="https://www.kde.org/"
179 if [[ ${KDE_BUILD_TYPE} = live && -z ${I_KNOW_WHAT_I_AM_DOING} ]]; then
180 # Disable tests for live ebuilds by default
184 # This code is to prevent portage from searching GENTOO_MIRRORS for
185 # packages that will never be mirrored. (As they only will ever be in
188 *9999* | 4.?.[6-9]? | 4.??.[6-9]? | ??.?.[6-9]? | ??.??.[6-9]?)
194 HOMEPAGE="https://www.kdevelop.org/"
199 # @ECLASS-VARIABLE: QT_MINIMAL
201 # Determine version of qt we enforce as minimal for the package.
202 QT_MINIMAL="${QT_MINIMAL:-4.8.5}"
204 # Declarative dependencies
205 qtdeclarativedepend="
206 >=dev-qt/qtdeclarative-${QT_MINIMAL}:4
208 case ${DECLARATIVE_REQUIRED} in
210 COMMONDEPEND+=" ${qtdeclarativedepend}"
214 COMMONDEPEND+=" declarative? ( ${qtdeclarativedepend} )"
218 unset qtdeclarativedepend
220 # QtHelp dependencies
222 >=dev-qt/qthelp-${QT_MINIMAL}:4
224 case ${QTHELP_REQUIRED} in
226 COMMONDEPEND+=" ${qthelpdepend}"
230 COMMONDEPEND+=" qthelp? ( ${qthelpdepend} )"
235 # OpenGL dependencies
237 >=dev-qt/qtopengl-${QT_MINIMAL}:4
239 case ${OPENGL_REQUIRED} in
241 COMMONDEPEND+=" ${qtopengldepend}"
245 COMMONDEPEND+=" opengl? ( ${qtopengldepend} )"
251 # MultiMedia dependencies
253 >=dev-qt/qtmultimedia-${QT_MINIMAL}:4
255 case ${MULTIMEDIA_REQUIRED} in
257 COMMONDEPEND+=" ${qtmultimediadepend}"
261 COMMONDEPEND+=" multimedia? ( ${qtmultimediadepend} )"
265 unset qtmultimediadepend
267 # WebKit dependencies
269 >=dev-qt/qtwebkit-${QT_MINIMAL}:4
271 case ${WEBKIT_REQUIRED} in
273 COMMONDEPEND+=" ${qtwebkitdepend}"
277 COMMONDEPEND+=" webkit? ( ${qtwebkitdepend} )"
283 # CppUnit dependencies
287 case ${CPPUNIT_REQUIRED} in
289 DEPEND+=" ${cppuintdepend}"
293 DEPEND+=" test? ( ${cppuintdepend} )"
300 # Qt accessibility classes are needed in various places, bug 325461
303 >=dev-qt/qt3support-${QT_MINIMAL}:4[accessibility]
304 >=dev-qt/qtcore-${QT_MINIMAL}:4[qt3support,ssl]
305 >=dev-qt/qtdbus-${QT_MINIMAL}:4
306 >=dev-qt/designer-${QT_MINIMAL}:4
307 >=dev-qt/qtgui-${QT_MINIMAL}:4[accessibility,dbus(+)]
308 >=dev-qt/qtscript-${QT_MINIMAL}:4
309 >=dev-qt/qtsql-${QT_MINIMAL}:4[qt3support]
310 >=dev-qt/qtsvg-${QT_MINIMAL}:4
311 >=dev-qt/qttest-${QT_MINIMAL}:4
314 if [[ ${PN} != kdelibs ]]; then
316 case ${WEBKIT_REQUIRED} in
317 always) _kdelibsuse="webkit" ;;
318 optional) _kdelibsuse="webkit?" ;;
321 kdecommondepend+=" || ( $(add_kdebase_dep kdelibs "${_kdelibsuse}" 4.14.22) <kde-base/kdelibs-4.14.22 )"
323 if [[ ${KDEBASE} = kdevelop ]]; then
324 if [[ ${PN} != kdevplatform ]]; then
325 # @ECLASS-VARIABLE: KDEVPLATFORM_REQUIRED
327 # Specifies whether kdevplatform is required. Possible values are 'always' (default) and 'never'.
328 # Applies to KDEBASE=kdevelop only.
329 KDEVPLATFORM_REQUIRED="${KDEVPLATFORM_REQUIRED:-always}"
330 case ${KDEVPLATFORM_REQUIRED} in
333 >=dev-util/kdevplatform-${KDEVPLATFORM_VERSION}:4
346 >=x11-libs/libXtst-1.1.0
347 x11-proto/xf86vidmodeproto
353 if [[ ${CATEGORY} == kde-apps ]]; then
354 kderdepend+=" !kde-base/${PN}:4"
357 # all packages needs oxygen icons for basic iconset
358 if [[ ${PN} != oxygen-icons ]]; then
359 kderdepend+=" kde-frameworks/oxygen-icons"
362 # add a dependency over kde4-l10n
363 if [[ ${KDEBASE} != "kde-base" && -n ${KDE_LINGUAS} ]]; then
364 for _lingua in $(kde4_lingua_to_l10n ${KDE_LINGUAS}); do
365 # if our package has linguas, pull in kde4-l10n with selected lingua enabled,
366 # but only for selected ones.
367 # this can't be done on one line because if user doesn't use any localisation
368 # then he is probably not interested in kde4-l10n at all.
370 l10n_${_lingua}? ( $(add_kdeapps_dep kde4-l10n "l10n_${_lingua}(+)") )
377 app-text/docbook-xml-dtd:4.2
378 app-text/docbook-xsl-stylesheets
381 $(add_kdebase_dep kdelibs 'handbook')
383 case ${KDE_HANDBOOK} in
385 kdedepend+=" ${kdehandbookdepend}"
386 [[ ${PN} != kdelibs ]] && kderdepend+=" ${kdehandbookrdepend}"
390 kcontrol | kdesu | knetattach)
397 kdedepend+=" handbook? ( ${kdehandbookdepend} )"
398 [[ ${PN} != kdelibs ]] && kderdepend+=" handbook? ( ${kdehandbookrdepend} )"
402 unset kdehandbookdepend kdehandbookrdepend
404 case ${KDE_SELINUX_MODULE} in
408 kderdepend+=" selinux? ( sec-policy/selinux-${KDE_SELINUX_MODULE} )"
412 # We always need the aqua useflag because otherwise we cannot = refer to it inside
413 # add_kdebase_dep. This was always kind of a bug, but came to light with EAPI=5
414 # (where referring to a use flag not in IUSE masks the ebuild).
415 # The only alternative would be to prohibit using add_kdebase_dep if KDE_REQUIRED=never
418 case ${KDE_REQUIRED} in
420 [[ -n ${kdecommondepend} ]] && COMMONDEPEND+=" ${kdecommondepend}"
421 [[ -n ${kdedepend} ]] && DEPEND+=" ${kdedepend}"
422 [[ -n ${kderdepend} ]] && RDEPEND+=" ${kderdepend}"
426 [[ -n ${kdecommondepend} ]] && COMMONDEPEND+=" kde? ( ${kdecommondepend} )"
427 [[ -n ${kdedepend} ]] && DEPEND+=" kde? ( ${kdedepend} )"
428 [[ -n ${kderdepend} ]] && RDEPEND+=" kde? ( ${kderdepend} )"
433 unset kdecommondepend kdedepend kderdepend
435 debug-print "${LINENO} ${ECLASS} ${FUNCNAME}: COMMONDEPEND is ${COMMONDEPEND}"
436 debug-print "${LINENO} ${ECLASS} ${FUNCNAME}: DEPEND (only) is ${DEPEND}"
437 debug-print "${LINENO} ${ECLASS} ${FUNCNAME}: RDEPEND (only) is ${RDEPEND}"
439 # Accumulate dependencies set by this eclass
440 DEPEND+=" ${COMMONDEPEND}"
441 RDEPEND+=" ${COMMONDEPEND}"
444 # Fetch section - If the ebuild's category is not 'kde-base' and if it is not a
445 # kdevelop ebuild, the URI should be set in the ebuild itself
446 _calculate_src_uri() {
447 debug-print-function ${FUNCNAME} "$@"
449 local _kmname _kmname_pv
451 # we calculate URI only for known KDEBASE modules
452 [[ -n ${KDEBASE} ]] || return
454 # calculate tarball module name
455 if [[ -n ${KMNAME} ]]; then
460 _kmname_pv="${_kmname}-${PV}"
465 # KDEPIM 4.4 no-akonadi branch, special case
466 # TODO: Remove this part when KDEPIM 4.4 gets out of the tree
467 SRC_URI="https://dev.gentoo.org/~dilfridge/distfiles/${_kmname_pv}.tar.xz" ;;
468 4.?.[6-9]? | 4.??.[6-9]?)
469 # Unstable KDE SC releases
470 SRC_URI="mirror://kde/unstable/${PV}/src/${_kmname_pv}.tar.xz" ;;
472 # Part of 15.08.0 actually, sigh. Not stable for next release!
473 SRC_URI="mirror://kde/stable/applications/15.08.0/src/${_kmname_pv}.tar.xz" ;;
476 SRC_URI="mirror://kde/stable/${PV}/src/${_kmname_pv}.tar.xz" ;;
478 # Part of 15.04.3 actually, sigh. Used by last version of KDE PIM 4.
479 SRC_URI="mirror://kde/Attic/applications/15.04.3/src/${_kmname_pv}.tar.xz" ;;
480 ??.?.[6-9]? | ??.??.[4-9]?)
481 # Unstable KDE Applications releases
482 SRC_URI="mirror://kde/unstable/applications/${PV}/src/${_kmname}-${PV}.tar.xz" ;;
484 # Stable KDE Applications releases
485 SRC_URI="mirror://kde/stable/applications/${PV}/src/${_kmname}-${PV}.tar.xz"
489 kdevelop|kdevelop-php*|kdevplatform)
490 case ${KDEVELOP_VERSION} in
491 4.[123].[6-9]*) SRC_URI="mirror://kde/unstable/kdevelop/${KDEVELOP_VERSION}/src/${P}.tar.xz" ;;
492 4.7.3) SRC_URI="mirror://kde/stable/kdevelop/${KDEVELOP_VERSION}/src/${P}.tar.bz2" ;;
493 *) SRC_URI="mirror://kde/stable/kdevelop/${KDEVELOP_VERSION}/src/${P}.tar.xz" ;;
499 _calculate_live_repo() {
500 debug-print-function ${FUNCNAME} "$@"
505 # Determine branch URL based on live type
510 branch_prefix="trunk/KDE"
514 branch_prefix="branches/KDE/$(get_kde_version)"
516 if [[ ${PV} == ??.??.49.9999 && ${CATEGORY} = kde-apps ]]; then
517 branch_prefix="branches/Applications/$(get_kde_version)"
520 # @ECLASS-VARIABLE: ESVN_PROJECT_SUFFIX
522 # Suffix appended to ESVN_PROJECT depending on fetched branch.
523 # Defaults is empty (for -9999 = trunk), and "-${PV}" otherwise.
524 ESVN_PROJECT_SUFFIX="-${PV}"
527 # @ECLASS-VARIABLE: ESVN_MIRROR
529 # This variable allows easy overriding of default kde mirror service
530 # (anonsvn) with anything else you might want to use.
531 ESVN_MIRROR=${ESVN_MIRROR:=svn://anonsvn.kde.org/home/kde}
532 # Split ebuild, or extragear stuff
533 if [[ -n ${KMNAME} ]]; then
534 ESVN_PROJECT="${KMNAME}${ESVN_PROJECT_SUFFIX}"
535 if [[ -z ${KMNOMODULE} ]] && [[ -z ${KMMODULE} ]]; then
538 # Split kde-base/ ebuilds: (they reside in trunk/KDE)
541 ESVN_REPO_URI="${ESVN_MIRROR}/${branch_prefix}/kdebase/${KMNAME#kdebase-}"
544 ESVN_REPO_URI="${ESVN_MIRROR}/${branch_prefix}/kdelibs/${KMNAME#kdelibs-}"
547 ESVN_REPO_URI="${ESVN_MIRROR}/trunk/${KMNAME}/${KMMODULE}"
550 ESVN_REPO_URI="${ESVN_MIRROR}/trunk/${KMNAME}/${KMMODULE}"
551 ESVN_PROJECT="${PN}${ESVN_PROJECT_SUFFIX}"
554 ESVN_REPO_URI="${ESVN_MIRROR}/${branch_prefix}/${KMNAME}"
556 extragear*|playground*)
557 # Unpack them in toplevel dir, so that they won't conflict with kde4-meta
558 # build packages from same svn location.
559 ESVN_REPO_URI="${ESVN_MIRROR}/trunk/${KMNAME}/${KMMODULE}"
560 ESVN_PROJECT="${PN}${ESVN_PROJECT_SUFFIX}"
563 ESVN_REPO_URI="${ESVN_MIRROR}/trunk/${KMNAME}/${KMMODULE}"
567 # kdelibs, kdepimlibs
568 ESVN_REPO_URI="${ESVN_MIRROR}/${branch_prefix}/${PN}"
569 ESVN_PROJECT="${PN}${ESVN_PROJECT_SUFFIX}"
571 # @ECLASS-VARIABLE: ESVN_UP_FREQ
573 # This variable is used for specifying the timeout between svn synces
574 # for kde-base modules. Does not affect misc apps.
575 # Default value is 1 hour.
576 [[ ${KDEBASE} = kde-base ]] && ESVN_UP_FREQ=${ESVN_UP_FREQ:-1}
580 # @ECLASS-VARIABLE: EGIT_MIRROR
582 # This variable allows easy overriding of default kde mirror service
583 # (anongit) with anything else you might want to use.
584 EGIT_MIRROR=${EGIT_MIRROR:=https://anongit.kde.org}
586 # @ECLASS-VARIABLE: EGIT_REPONAME
588 # This variable allows overriding of default repository
589 # name. Specify only if this differ from PN and KMNAME.
590 if [[ -n ${EGIT_REPONAME} ]]; then
591 # the repository and kmname different
592 _kmname=${EGIT_REPONAME}
593 elif [[ -n ${KMNAME} ]]; then
600 [[ ${PV} != 4.9999* && ${PV} != 9999 && ${KDEBASE} == kde-base ]] && \
601 EGIT_BRANCH="KDE/$(get_kde_version)"
603 # Applications branching
604 [[ ${PV} == ??.??.49.9999 && ${KDEBASE} == kde-base ]] && \
605 EGIT_BRANCH="Applications/$(get_kde_version)"
608 EGIT_REPO_URI+=( "${EGIT_MIRROR}/${_kmname}" )
610 debug-print "${FUNCNAME}: Repository: ${EGIT_REPO_URI}"
611 debug-print "${FUNCNAME}: Branch: ${EGIT_BRANCH}"
616 case ${KDE_BUILD_TYPE} in
617 live) _calculate_live_repo ;;
618 *) _calculate_src_uri ;;
621 debug-print "${LINENO} ${ECLASS} ${FUNCNAME}: SRC_URI is ${SRC_URI}"
623 # @ECLASS-VARIABLE: PREFIX
625 # Set the installation PREFIX for non kde-base applications. It defaults to /usr.
626 # kde-base packages go into KDE4 installation directory (/usr).
627 # No matter the PREFIX, package will be built against KDE installed in /usr.
629 # @FUNCTION: kde4-base_pkg_setup
631 # Do some basic settings
632 kde4-base_pkg_setup() {
633 debug-print-function ${FUNCNAME} "$@"
635 if has handbook ${IUSE} || has "+handbook" ${IUSE} && [ "${KDE_HANDBOOK}" != optional ] ; then
636 eqawarn "Handbook support is enabled via KDE_HANDBOOK=optional in the ebuild."
637 eqawarn "Please do not just set IUSE=handbook, as this leads to dependency errors."
640 # Don't set KDEHOME during compilation, it will cause access violations
643 # Check if gcc compiler is fresh enough.
644 # In theory should be in pkg_pretend but we check it only for kdelibs there
645 # and for others we do just quick scan in pkg_setup because pkg_pretend
646 # executions consume quite some time (ie. when merging 300 packages at once will cause 300 checks)
647 if [[ ${MERGE_TYPE} != binary ]] && tc-is-gcc; then
648 [[ $(gcc-major-version) -lt 4 ]] || \
649 ( [[ $(gcc-major-version) -eq 4 && $(gcc-minor-version) -le 6 ]] ) \
650 && die "Sorry, but gcc-4.6 and earlier wont work for some KDE packages."
655 EKDEDIR=${EPREFIX}/usr
657 # Point to correct QT plugins path
658 QT_PLUGIN_PATH="${EPREFIX}/usr/$(get_libdir)/kde4/plugins/"
660 # Fix XDG collision with sandbox
661 export XDG_CONFIG_HOME="${T}"
664 # @FUNCTION: kde4-base_src_unpack
666 # This function unpacks the source tarballs for KDE4 applications.
667 kde4-base_src_unpack() {
668 debug-print-function ${FUNCNAME} "$@"
670 if [[ ${KDE_BUILD_TYPE} = live ]]; then
673 subversion_src_unpack
684 # @FUNCTION: kde4-base_src_prepare
686 # General pre-configure and pre-compile function for KDE4 applications.
687 # It also handles translations if KDE_LINGUAS is defined. See KDE_LINGUAS and
688 # enable_selected_linguas() and enable_selected_doc_linguas()
689 # in kde4-functions.eclass(5) for further details.
690 kde4-base_src_prepare() {
691 debug-print-function ${FUNCNAME} "$@"
693 # enable handbook and linguas only when not using live ebuild
695 # Only enable selected languages, used for KDE extragear apps.
696 if [[ -n ${KDE_LINGUAS} ]]; then
697 enable_selected_linguas
700 # Enable/disable handbooks for kde4-base packages
701 # kde4-l10n inherits kde4-base but is metapackage, so no check for doc
702 # kdelibs inherits kde4-base but handle installing the handbook itself
703 if ! has kde4-meta ${INHERITED} && in_iuse handbook; then
704 if [[ ${KDEBASE} == kde-base ]]; then
705 if [[ ${PN} != kde4-l10n && ${PN} != kdepim-l10n && ${PN} != kdelibs ]] && use !handbook; then
706 # documentation in kde4-functions
707 : ${KDE_DOC_DIRS:=doc}
709 for dir in ${KDE_DOC_DIRS}; do
710 sed -e "\!^[[:space:]]*add_subdirectory[[:space:]]*([[:space:]]*${dir}[[:space:]]*)!s/^/#DONOTCOMPILE /" \
711 -e "\!^[[:space:]]*ADD_SUBDIRECTORY[[:space:]]*([[:space:]]*${dir}[[:space:]]*)!s/^/#DONOTCOMPILE /" \
712 -e "\!^[[:space:]]*macro_optional_add_subdirectory[[:space:]]*([[:space:]]*${dir}[[:space:]]*)!s/^/#DONOTCOMPILE /" \
713 -e "\!^[[:space:]]*MACRO_OPTIONAL_ADD_SUBDIRECTORY[[:space:]]*([[:space:]]*${dir}[[:space:]]*)!s/^/#DONOTCOMPILE /" \
714 -i CMakeLists.txt || die "failed to comment out handbook"
718 enable_selected_doc_linguas
723 if [[ ${KDE_BUILD_TYPE} = live ]]; then
725 svn) subversion_src_prepare ;;
729 # Apply patches, cmake-utils does the job already
730 cmake-utils_src_prepare
732 # Save library dependencies
733 if [[ -n ${KMSAVELIBS} ]] ; then
734 save_library_dependencies
737 # Inject library dependencies
738 if [[ -n ${KMLOADLIBS} ]] ; then
739 load_library_dependencies
742 # Hack for manuals relying on outdated DTD, only outside kde-base/...
743 if [[ -z ${KDEBASE} ]]; then
744 find "${S}" -name "*.docbook" \
746 -e 's:-//KDE//DTD DocBook XML V4\.1(\..)?-Based Variant V1\.[01]//EN:-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN:g' {} + \
747 || die 'failed to fix DocBook variant version'
751 # @FUNCTION: kde4-base_src_configure
753 # Function for configuring the build of KDE4 applications.
754 kde4-base_src_configure() {
755 debug-print-function ${FUNCNAME} "$@"
757 # Build tests in src_test only, where we override this value
758 local cmakeargs=(-DKDE4_BUILD_TESTS=OFF)
760 if use_if_iuse debug; then
761 # Set "real" debug mode
762 CMAKE_KDE_BUILD_TYPE="Debugfull"
764 # Handle common release builds
765 append-cppflags -DQT_NO_DEBUG
768 # Set distribution name
769 [[ ${PN} = kdelibs ]] && cmakeargs+=(-DKDE_DISTRIBUTION_TEXT=Gentoo)
771 # Here we set the install prefix
772 tc-is-cross-compiler || cmakeargs+=(-DCMAKE_INSTALL_PREFIX="${EPREFIX}${PREFIX}")
777 # Shadow existing installations
780 #qmake -query QT_INSTALL_LIBS unavailable when cross-compiling
781 tc-is-cross-compiler && cmakeargs+=(-DQT_LIBRARY_DIR=${ROOT}/usr/$(get_libdir)/qt4)
782 #kde-config -path data unavailable when cross-compiling
783 tc-is-cross-compiler && cmakeargs+=(-DKDE4_DATA_DIR=${ROOT}/usr/share/apps/)
785 # sysconf needs to be /etc, not /usr/etc
786 cmakeargs+=(-DSYSCONF_INSTALL_DIR="${EPREFIX}"/etc)
788 if [[ $(declare -p mycmakeargs 2>&-) != "declare -a mycmakeargs="* ]]; then
789 if [[ ${mycmakeargs} ]]; then
790 eqawarn "mycmakeargs should always be declared as an array, not a string"
792 mycmakeargs=(${mycmakeargs})
795 mycmakeargs=("${cmakeargs[@]}" "${mycmakeargs[@]}")
797 cmake-utils_src_configure
800 # @FUNCTION: kde4-base_src_compile
802 # General function for compiling KDE4 applications.
803 kde4-base_src_compile() {
804 debug-print-function ${FUNCNAME} "$@"
806 cmake-utils_src_compile "$@"
809 # @FUNCTION: kde4-base_src_test
811 # Function for testing KDE4 applications.
812 kde4-base_src_test() {
813 debug-print-function ${FUNCNAME} "$@"
818 if [[ -n "${VIRTUALDBUS_TEST}" ]]; then
819 export $(dbus-launch)
820 kded4 2>&1 > /dev/null &
827 # When run as normal user during ebuild development with the ebuild command, the
828 # kde tests tend to access the session DBUS. This however is not possible in a real
829 # emerge or on the tinderbox.
830 # > make sure it does not happen, so bad tests can be recognized and disabled
831 unset DBUS_SESSION_BUS_ADDRESS DBUS_SESSION_BUS_PID
833 # Override this value, set in kde4-base_src_configure()
834 mycmakeargs+=(-DKDE4_BUILD_TESTS=ON)
835 cmake-utils_src_configure
836 kde4-base_src_compile
838 if [[ ${VIRTUALX_REQUIRED} == always || ${VIRTUALX_REQUIRED} == test ]]; then
839 # check for sanity if anyone already redefined VIRTUALX_COMMAND from the default
840 if [[ ${VIRTUALX_COMMAND} != emake ]]; then
841 # surprise- we are already INSIDE virtualmake!!!
842 debug-print "QA Notice: This version of kde4-base.eclass includes the virtualx functionality."
843 debug-print " You may NOT set VIRTUALX_COMMAND or call virtualmake from the ebuild."
844 debug-print " Setting VIRTUALX_REQUIRED is completely sufficient. See the"
845 debug-print " kde4-base.eclass docs for details... Applying workaround."
854 if [ -n "${kded4_pid}" ] ; then
858 if [ -n "${DBUS_SESSION_BUS_PID}" ] ; then
859 kill ${DBUS_SESSION_BUS_PID}
863 # @FUNCTION: kde4-base_src_install
865 # Function for installing KDE4 applications.
866 kde4-base_src_install() {
867 debug-print-function ${FUNCNAME} "$@"
869 if [[ -n ${KMSAVELIBS} ]] ; then
870 install_library_dependencies
873 # Install common documentation of KDE4 applications
875 if ! has kde4-meta ${INHERITED}; then
876 for doc in "${S}"/{AUTHORS,CHANGELOG,ChangeLog*,README*,NEWS,TODO,HACKING}; do
877 [[ -f ${doc} && -s ${doc} ]] && dodoc "${doc}"
879 for doc in "${S}"/*/{AUTHORS,CHANGELOG,ChangeLog*,README*,NEWS,TODO,HACKING}; do
880 [[ -f ${doc} && -s ${doc} ]] && newdoc "${doc}" "$(basename $(dirname ${doc})).$(basename ${doc})"
884 cmake-utils_src_install
886 # We don't want ${PREFIX}/share/doc/HTML to be compressed,
887 # because then khelpcenter can't find the docs
888 [[ -d ${ED}/${PREFIX}/share/doc/HTML ]] &&
889 docompress -x ${PREFIX}/share/doc/HTML
892 # @FUNCTION: kde4-base_pkg_preinst
894 # Function storing icon caches
895 kde4-base_pkg_preinst() {
896 debug-print-function ${FUNCNAME} "$@"
899 if [[ ${KDE_BUILD_TYPE} == live && ${KDE_SCM} == svn ]]; then
900 subversion_pkg_preinst
904 # @FUNCTION: kde4-base_pkg_postinst
906 # Function to rebuild the KDE System Configuration Cache after an application has been installed.
907 kde4-base_pkg_postinst() {
908 debug-print-function ${FUNCNAME} "$@"
910 gnome2_icon_cache_update
911 fdo-mime_desktop_database_update
912 fdo-mime_mime_database_update
915 if [[ -z ${I_KNOW_WHAT_I_AM_DOING} ]]; then
916 if [[ ${KDE_BUILD_TYPE} = live ]]; then
918 einfo "WARNING! This is an experimental live ebuild of ${CATEGORY}/${PN}"
919 einfo "Use it at your own risk."
920 einfo "Do _NOT_ file bugs at bugs.gentoo.org because of this ebuild!"
926 # @FUNCTION: kde4-base_pkg_postrm
928 # Function to rebuild the KDE System Configuration Cache after an application has been removed.
929 kde4-base_pkg_postrm() {
930 debug-print-function ${FUNCNAME} "$@"
932 gnome2_icon_cache_update
933 fdo-mime_desktop_database_update
934 fdo-mime_mime_database_update