# Copyright 1999-2010 Gentoo Foundation # Distributed under the terms of the GNU General Public License v2 # $Header: /var/cvsroot/gentoo-x86/eclass/kde4-base.eclass,v 1.59 2010/04/07 21:16:33 scarabeus Exp $ # @ECLASS: kde4-base.eclass # @MAINTAINER: # kde@gentoo.org # @BLURB: This eclass provides functions for kde 4.X ebuilds # @DESCRIPTION: # The kde4-base.eclass provides support for building KDE4 based ebuilds # and KDE4 applications. # # NOTE: KDE 4 ebuilds by default define EAPI="2", this can be redefined but # eclass will fail with version older than 2. # @ECLASS-VARIABLE: CMAKE_REQUIRED # @DESCRIPTION: # Specify if cmake buildsystem is being used. Possible values are 'always' and 'never'. # Please note that if it's set to 'never' you need to explicitly override following phases: # src_configure, src_compile, src_test and src_install. # Defaults to 'always'. : ${CMAKE_REQUIRED:=always} if [[ ${CMAKE_REQUIRED} = false || ${CMAKE_REQUIRED} = never ]]; then buildsystem_eclass="" export_fns="" else buildsystem_eclass="cmake-utils" export_fns="src_configure src_compile src_test src_install" fi inherit kde4-functions get_build_type if [[ ${BUILD_TYPE} = live ]]; then subversion_eclass="subversion" fi inherit base ${buildsystem_eclass} eutils ${subversion_eclass} EXPORT_FUNCTIONS pkg_setup src_unpack src_prepare ${export_fns} pkg_postinst pkg_postrm unset buildsystem_eclass unset export_fns unset subversion_eclass case ${KDEBASE} in kde-base) HOMEPAGE="http://www.kde.org/" LICENSE="GPL-2" ;; koffice) HOMEPAGE="http://www.koffice.org/" LICENSE="GPL-2" ;; esac # @ECLASS-VARIABLE: OPENGL_REQUIRED # @DESCRIPTION: # Is qt-opengl required? Possible values are 'always', 'optional' and 'never'. # This variable must be set before inheriting any eclasses. Defaults to 'never'. OPENGL_REQUIRED="${OPENGL_REQUIRED:-never}" # @ECLASS-VARIABLE: MULTIMEDIA_REQUIRED # @DESCRIPTION: # Is qt-multimedia required? Possible values are 'always', 'optional' and 'never'. # This variable must be set before inheriting any eclasses. Defaults to 'never'. MULTIMEDIA_REQUIRED="${MULTIMEDIA_REQUIRED:-never}" # @ECLASS-VARIABLE: WEBKIT_REQUIRED # @DESCRIPTION: # Is qt-webkit requred? Possible values are 'always', 'optional' and 'never'. # This variable must be set before inheriting any eclasses. Defaults to 'never'. WEBKIT_REQUIRED="${WEBKIT_REQUIRED:-never}" # @ECLASS-VARIABLE: CPPUNIT_REQUIRED # @DESCRIPTION: # Is cppunit required for tests? Possible values are 'always', 'optional' and 'never'. # This variable must be set before inheriting any eclasses. Defaults to 'never'. CPPUNIT_REQUIRED="${CPPUNIT_REQUIRED:-never}" # @ECLASS-VARIABLE: KDE_REQUIRED # @DESCRIPTION: # Is kde required? Possible values are 'always', 'optional' and 'never'. # This variable must be set before inheriting any eclasses. Defaults to 'always' # If set to always or optional, KDE_MINIMAL may be overriden as well. # Note that for kde-base packages this variable is fixed to 'always'. KDE_REQUIRED="${KDE_REQUIRED:-always}" # Verify KDE_MINIMAL (display QA notice in pkg_setup, still we need to fix it here) if [[ -n ${KDE_MINIMAL} ]]; then for slot in ${KDE_SLOTS[@]} ${KDE_LIVE_SLOTS[@]}; do [[ ${KDE_MINIMAL} = ${slot} ]] && KDE_MINIMAL_VALID=1 && break done unset slot [[ -z ${KDE_MINIMAL_VALID} ]] && unset KDE_MINIMAL else KDE_MINIMAL_VALID=1 fi # @ECLASS-VARIABLE: KDE_MINIMAL # @DESCRIPTION: # This variable is used when KDE_REQUIRED is set, to specify required KDE minimal # version for apps to work. Currently defaults to 4.3 # One may override this variable to raise version requirements. # For possible values look at KDE_SLOTS and KDE_LIVE_SLOTS variables. # Note that it is fixed to ${SLOT} for kde-base packages. KDE_MINIMAL="${KDE_MINIMAL:-4.3}" # Setup packages inheriting this eclass case ${KDEBASE} in kde-base) if [[ $BUILD_TYPE = live ]]; then # Disable tests for live ebuilds RESTRICT+=" test" # Live ebuilds in kde-base default to kdeprefix by default IUSE+=" +kdeprefix" else # All other ebuild types default to -kdeprefix as before IUSE+=" kdeprefix" fi # Determine SLOT from PVs case ${PV} in *.9999*) SLOT="${PV/.9999*/}" ;; # stable live 4.5* | 4.4.[6-9]*) SLOT="4.5" ;; 4.4* | 4.3.[6-9]*) SLOT="4.4" ;; 4.3*) SLOT="4.3" ;; 9999*) SLOT="live" ;; # regular live *) die "Unsupported ${PV}" ;; esac # This code is to prevent portage from searching GENTOO_MIRRORS for # packages that will never be mirrored. (As they only will ever be in # the overlay). case ${PV} in *9999* | 4.?.[6-9]?) RESTRICT+=" mirror" ;; esac KDE_MINIMAL="${SLOT}" _kdedir="${SLOT}" # Block installation of other SLOTS unless kdeprefix RDEPEND+=" $(block_other_slots)" ;; koffice) SLOT="2" ;; esac # @ECLASS-VARIABLE: QT_MINIMAL # @DESCRIPTION: # Determine version of qt we enforce as minimal for the package. 4.4.0 4.5.1.. # Currently defaults to 4.5.1 for KDE 4.3 and earlier # or 4.6.0_rc1 for KDE 4.4 and later if slot_is_at_least 4.4 "${KDE_MINIMAL}"; then QT_MINIMAL="${QT_MINIMAL:-4.6.0}" fi QT_MINIMAL="${QT_MINIMAL:-4.5.1}" # OpenGL dependencies qtopengldepend=" >=x11-libs/qt-opengl-${QT_MINIMAL}:4 " case ${OPENGL_REQUIRED} in always) COMMONDEPEND+=" ${qtopengldepend}" ;; optional) IUSE+=" opengl" COMMONDEPEND+=" opengl? ( ${qtopengldepend} )" ;; *) ;; esac unset qtopengldepend # MultiMedia dependencies qtmultimediadepend=" >=x11-libs/qt-multimedia-${QT_MINIMAL}:4 " case ${MULTIMEDIA_REQUIRED} in always) COMMONDEPEND+=" ${qtmultimediadepend}" ;; optional) IUSE+=" multimedia" COMMONDEPEND+=" multimedia? ( ${qtmultimediadepend} )" ;; *) ;; esac unset qtmultimediadepend # WebKit dependencies case ${KDE_REQUIRED} in always) qtwebkitusedeps="[kde]" ;; optional) qtwebkitusedeps="[kde?]" ;; *) ;; esac qtwebkitdepend=" >=x11-libs/qt-webkit-${QT_MINIMAL}:4${qtwebkitusedeps} " unset qtwebkitusedeps case ${WEBKIT_REQUIRED} in always) COMMONDEPEND+=" ${qtwebkitdepend}" ;; optional) IUSE+=" webkit" COMMONDEPEND+=" webkit? ( ${qtwebkitdepend} )" ;; *) ;; esac unset qtwebkitdepend # CppUnit dependencies cppuintdepend=" dev-util/cppunit " case ${CPPUNIT_REQUIRED} in always) DEPEND+=" ${cppuintdepend}" ;; optional) IUSE+=" test" DEPEND+=" test? ( ${cppuintdepend} )" ;; *) ;; esac unset cppuintdepend # KDE dependencies kdecommondepend=" dev-lang/perl >=x11-libs/qt-core-${QT_MINIMAL}:4[qt3support,ssl] >=x11-libs/qt-gui-${QT_MINIMAL}:4[dbus] >=x11-libs/qt-qt3support-${QT_MINIMAL}:4[kde] >=x11-libs/qt-script-${QT_MINIMAL}:4 >=x11-libs/qt-sql-${QT_MINIMAL}:4[qt3support] >=x11-libs/qt-svg-${QT_MINIMAL}:4 >=x11-libs/qt-test-${QT_MINIMAL}:4 !aqua? ( x11-libs/libXext x11-libs/libXt x11-libs/libXxf86vm ) " if [[ ${PN} != kdelibs ]]; then if [[ ${KDEBASE} = kde-base ]]; then kdecommondepend+=" $(add_kdebase_dep kdelibs)" # libknotificationitem only when SLOT is 4.3 [[ ${PN} != libknotificationitem ]] && [[ ${SLOT} = 4.3 ]] && \ kdecommondepend+=" $(add_kdebase_dep libknotificationitem)" else kdecommondepend+=" >=kde-base/kdelibs-${KDE_MINIMAL} " fi fi kdedepend=" dev-util/pkgconfig !aqua? ( || ( >=x11-libs/libXtst-1.1.0 >> Unpacking ${file} to ${PWD}" xz -dc "${DISTDIR}"/${file} | tar xof - assert "failed unpacking ${file}" ;; *) unpack ${file} ;; esac done else # For EAPI >= 3, we can just use unpack() directly unpack ${A} fi } # @FUNCTION: kde4-base_src_prepare # @DESCRIPTION: # General pre-configure and pre-compile function for KDE4 applications. # It also handles translations if KDE_LINGUAS is defined. See KDE_LINGUAS and # enable_selected_linguas() and enable_selected_doc_linguas() # in kde4-functions.eclass(5) for further details. kde4-base_src_prepare() { debug-print-function ${FUNCNAME} "$@" # Only enable selected languages, used for KDE extragear apps. if [[ -n ${KDE_LINGUAS} ]]; then enable_selected_linguas fi # Enable/disable handbooks for kde4-base packages # kde-l10n inherits kde4-base but is metpackage, so no check for doc # kdelibs inherits kde4-base but handle installing the handbook itself if ! has kde4-meta ${INHERITED}; then has handbook ${IUSE//+} && [[ ${PN} != kde-l10n ]] && [[ ${PN} != kdelibs ]] && enable_selected_doc_linguas fi [[ ${BUILD_TYPE} = live ]] && subversion_src_prepare # Apply patches base_src_prepare epatch_user # Save library dependencies if [[ -n ${KMSAVELIBS} ]] ; then save_library_dependencies fi # Inject library dependencies if [[ -n ${KMLOADLIBS} ]] ; then load_library_dependencies fi } # @FUNCTION: kde4-base_src_configure # @DESCRIPTION: # Function for configuring the build of KDE4 applications. kde4-base_src_configure() { debug-print-function ${FUNCNAME} "$@" # Build tests in src_test only, where we override this value local cmakeargs=(-DKDE4_BUILD_TESTS=OFF) if has kdeenablefinal ${IUSE//+} && use kdeenablefinal; then cmakeargs+=(-DKDE4_ENABLE_FINAL=ON) fi if has debug ${IUSE//+} && use debug; then # Set "real" debug mode CMAKE_BUILD_TYPE="Debugfull" else # Handle common release builds append-cppflags -DQT_NO_DEBUG fi # Set distribution name [[ ${PN} = kdelibs ]] && cmakeargs+=(-DKDE_DISTRIBUTION_TEXT=Gentoo) # Here we set the install prefix cmakeargs+=(-DCMAKE_INSTALL_PREFIX="${EPREFIX}${PREFIX}") # Use colors QTEST_COLORED=1 # Shadow existing /usr installations unset KDEDIRS # Handle kdeprefix-ed KDE if [[ ${KDEDIR} != /usr ]]; then # Override some environment variables - only when kdeprefix is different, # to not break ccache/distcc PATH="${EKDEDIR}/bin:${PATH}" LDPATH="${EKDEDIR}/$(get_libdir)${LDPATH+:}${LDPATH}" # Append full RPATH cmakeargs+=(-DCMAKE_SKIP_RPATH=OFF) # Set cmake prefixes to allow buildsystem to locate valid KDE installation # when more are present cmakeargs+=(-DCMAKE_SYSTEM_PREFIX_PATH="${EKDEDIR}") fi # Handle kdeprefix in application itself if ! has kdeprefix ${IUSE//+} || ! use kdeprefix; then # If prefix is /usr, sysconf needs to be /etc, not /usr/etc cmakeargs+=(-DSYSCONF_INSTALL_DIR="${EPREFIX}"/etc) fi if [[ $(declare -p mycmakeargs 2>&-) != "declare -a mycmakeargs="* ]]; then mycmakeargs=(${mycmakeargs}) fi mycmakeargs=("${cmakeargs[@]}" "${mycmakeargs[@]}") cmake-utils_src_configure } # @FUNCTION: kde4-base_src_compile # @DESCRIPTION: # General function for compiling KDE4 applications. kde4-base_src_compile() { debug-print-function ${FUNCNAME} "$@" cmake-utils_src_compile "$@" } # @FUNCTION: kde4-base_src_test # @DESCRIPTION: # Function for testing KDE4 applications. kde4-base_src_test() { debug-print-function ${FUNCNAME} "$@" # Override this value, set in kde4-base_src_configure() mycmakeargs+=(-DKDE4_BUILD_TESTS=ON) cmake-utils_src_configure kde4-base_src_compile cmake-utils_src_test } # @FUNCTION: kde4-base_src_install # @DESCRIPTION: # Function for installing KDE4 applications. kde4-base_src_install() { debug-print-function ${FUNCNAME} "$@" # Prefix support, for usage in ebuilds if [[ ${EAPI} == 2 ]] && ! use prefix; then ED=${D} fi if [[ -n ${KMSAVELIBS} ]] ; then install_library_dependencies fi kde4-base_src_make_doc cmake-utils_src_install } # @FUNCTION: kde4-base_src_make_doc # @DESCRIPTION: # Function for installing the documentation of KDE4 applications. kde4-base_src_make_doc() { debug-print-function ${FUNCNAME} "$@" local doc for doc in AUTHORS ChangeLog* README* NEWS TODO; do [[ -s ${doc} ]] && dodoc ${doc} done if [[ -z ${KMNAME} ]]; then for doc in {apps,runtime,workspace,.}/*/{AUTHORS,README*}; do if [[ -s ${doc} ]]; then local doc_complete=${doc} doc="${doc#*/}" newdoc "$doc_complete" "${doc%/*}.${doc##*/}" fi done fi } # @FUNCTION: kde4-base_pkg_postinst # @DESCRIPTION: # Function to rebuild the KDE System Configuration Cache after an application has been installed. kde4-base_pkg_postinst() { debug-print-function ${FUNCNAME} "$@" buildsycoca if [[ ${BUILD_TYPE} = live ]] && [[ -z ${I_KNOW_WHAT_I_AM_DOING} ]]; then echo einfo "WARNING! This is an experimental live ebuild of ${CATEGORY}/${PN}" einfo "Use it at your own risk." einfo "Do _NOT_ file bugs at bugs.gentoo.org because of this ebuild!" echo elif [[ ${BUILD_TYPE} != live ]] && [[ -z ${I_KNOW_WHAT_I_AM_DOING} ]] && has kdeprefix ${IUSE//+} && use kdeprefix; then # warning about kdeprefix for non-live users echo ewarn "WARNING! You have the kdeprefix useflag enabled." ewarn "This setting is strongly discouraged and might lead to potential trouble" ewarn "with KDE update strategies." ewarn "You are using this setup at your own risk and the kde team does not" ewarn "take responsibilities for dead kittens." echo fi if [[ -z ${I_KNOW_WHAT_I_AM_DOING} ]] && ! has_version 'kde-base/kdebase-runtime-meta' && ! has_version 'kde-base/kdebase-startkde'; then # warn about not supported approach if [[ ${KDE_REQUIRED} == always ]] || ( [[ ${KDE_REQUIRED} == optional ]] && use kde ); then echo ewarn "WARNING! Your system configuration contains neither \"kde-base/kdebase-runtime-meta\"" ewarn "nor \"kde-base/kdebase-startkde\". You need one of above." ewarn "With this setting you are unsupported by KDE team." ewarn "All missing features you report for misc packages will be probably ignored or closed as INVALID." fi fi } # @FUNCTION: kde4-base_pkg_postrm # @DESCRIPTION: # Function to rebuild the KDE System Configuration Cache after an application has been removed. kde4-base_pkg_postrm() { debug-print-function ${FUNCNAME} "$@" buildsycoca }