Gentoo Development Guide

KDE4-FUNCTIONS.ECLASS

Section: portage (5)
Updated: Dec 2014
Index Return to Main Contents
 

NAME

kde4-functions.eclass - Common ebuild functions for KDE 4 packages  

DESCRIPTION

This eclass contains all functions shared by the different eclasses, for KDE 4 ebuilds.  

FUNCTIONS

buildsycoca
Function to rebuild the KDE System Configuration Cache. All KDE ebuilds should run this in pkg_postinst and pkg_postrm.
comment_add_subdirectory subdirectory
Comment out an add_subdirectory call in CMakeLists.txt in the current directory
comment_all_add_subdirectory [list of directory names]
Recursively comment all add_subdirectory instructions in listed directories, except those in cmake/.
enable_selected_linguas
Enable translations based on LINGUAS settings and translations supported by the package (see KDE_LINGUAS). By default, translations are found in "${S}"/po but this default can be overridden by defining KDE_LINGUAS_DIR.
enable_selected_doc_linguas
Enable only selected linguas enabled doc folders.
save_library_dependencies
Add exporting CMake dependencies for current package
install_library_dependencies
Install generated CMake library dependencies to /var/lib/kde
load_library_dependencies
Inject specified library dependencies in current package
add_kdebase_dep
Create proper dependency for kde-base/ dependencies. This takes 1 to 3 arguments. The first being the package name, the optional second is additional USE flags to append, and the optional third is the version to use instead of the automatic version (use sparingly). The output of this should be added directly to DEPEND/RDEPEND, and may be wrapped in a USE conditional (but not an || conditional without an extra set of parentheses).
get_kde_version
Translates an ebuild version into a major.minor KDE SC release version. If no version is specified, ${PV} is used.
 

ECLASS VARIABLES

EAPI
Currently kde4 eclasses support EAPI 4 and 5.
KDE_OVERRIDE_MINIMAL
For use only in very few well-defined cases; normally it should be unset. If this variable is set, all calls to add_kdebase_dep return a dependency on at least this version, independent of the version of the package itself. If you know exactly that one specific NEW KDE component builds and runs fine with all the rest of KDE at an OLDER version, you can set this old version here. Warning- may lead to general instability and kill your pet targh.
KDEBASE
This gets set to a non-zero value when a package is considered a kde or kdevelop ebuild.
KDE_SCM = "${KDE_SCM:-git}"
If this is a live package which scm does it use Everything else uses git by default
KDE_LINGUAS
This is a whitespace-separated list of translations this ebuild supports. These translations are automatically added to IUSE. Therefore ebuilds must set this variable before inheriting any eclasses. To enable only selected translations, ebuilds must call enable_selected_linguas(). kde4-{base,meta}.eclass does this for you.

Example: KDE_LINGUAS="de en_GB nl"

 

MAINTAINERS

kde@gentoo.org
 

REPORTING BUGS

Please report bugs via http://bugs.gentoo.org/  

FILES

/usr/portage/eclass/kde4-functions.eclass  

SEE ALSO

ebuild(5)
http://sources.gentoo.org/eclass/kde4-functions.eclass?view=log


 

Index

NAME
DESCRIPTION
FUNCTIONS
ECLASS VARIABLES
MAINTAINERS
REPORTING BUGS
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 03:25:06 GMT, December 21, 2014