Gentoo Logo

Gentoo KDE kdebuild-1 EAPI Guide

Content:

1.  Introduction

A short history of kdebuild-1

The Gentoo KDE project has provided an official overlay with KDE4 live ebuilds ("kde" in layman/playman) and some of their dependencies for quite some time.

The team's progress has been impaired by the absence of features like standardised live ebuilds as per GLEP 54, USE dependencies and package dependency labels.

Thus, the idea arose to create a new, stable EAPI for use in the overlay for live ebuilds as those would benefit the most from those features.

Unfortunately, Portage doesn't support any of those features yet and so the team decided to use Paludis.

After some discussion with Ciaran McCreesh we came up with kdebuild-1.

2.  Features of kdebuild-1

The kdeuild-1 EAPI is based upon EAPI 1 with some notable additions and changes. This chapter outlines those differences and gives a short reasoning for them.

For detailed information you should refer to PMS (pdf).

New features

Feature References PMS chapter
"-scm" version support GLEP 54 2.2 Version Specifications
".kdebuild-1" filename suffix GLEP 55 3.3 Package Directories
USE dependencies Bug 2272 9.2.5 Package Dependency Specifications
Ranged dependencies 9.2.5 Package Dependency Specifications
:* and := slot dependency operators 9.2.5 Package Dependency Specifications
SRC_URI arrows Bug 177863 9.2.8 SRC_URI
SRC_URI labels Bug 201499 9.2.8 SRC_URI
Mandatory src_test 10.1.4 src_test
No implicit mkdir for doins
dohtml, dohard and dosed are banned 11.3.3 Ebuild-specific Commands
Old-style virtuals are banned 8.3 Optional Ebuild-defined Variables
pkg_info can be used on uninstalled packages 10.1.11 pkg_info
PDEPEND "suggested" label 9.2.6 Package Dependency Labels

3.  Current use of kdebuild-1

kdebuild-1 is currently being used for for live ebuilds (${PV}=-scm) in the KDE overlays only, so that users of other PMs will be able to use the rest of the overlay as before. That's exactly what the kdebuild-1 EAPI was designed to allow for.

For users of the KDE overlay's live ebuilds the new EAPI currently means they will have to use Paludis. As other package managers might be interested in the features of kdebuild-1, too, it's optionally included in PMS.

For the KDE team using kdebuild-1 means we will be able to use exciting new features and make our lifes easier.

For Gentoo as a whole this means there's plenty of opportunity to try new stuff and learn from the experiences.



Print

Updated April 16, 2008

Summary: This guide provides the information needed to understand and use the Gentoo KDE project's kdebuild-1 EAPI.

Wulf Krueger
Author

Donate to support our development efforts.

Support OSL

Support OSL

Gentoo Centric Hosting: vr.org

VR Hosted

Tek Alchemy

Tek Alchemy

SevenL.net

SevenL.net

Global Netoptex Inc.

Global Netoptex Inc.

Linux World Expo

Linux World Expo

Copyright 2001-2008 Gentoo Foundation, Inc. Questions, Comments? Contact us.