Gentoo KDE kdebuild-1 EAPI Guide
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.
The contents of this document are licensed under the Creative Commons -
Attribution / Share Alike license.
|