Project:PMS

From Gentoo Wiki
Jump to: navigation, search
Package Manager Specification
Description The Package Manager Specification aims to document what is required of a Gentoo package manager, and what ebuilds may assume about their environment.
Email pms-bugs@gentoo.org
IRC Channel #gentoo-dev
Lead(s)
Members
Parent Project Quality Assurance
Subprojects
Tags
Project listing

Introduction

In the past, the ebuild environment has been defined by what Portage has supported. With the advent of alternative package managers, such a moving standard is no longer sufficient. The Package Manager Specification (PMS) aims to solve this by defining, independent of any package manager, what is and is not allowed in the tree, and what ebuilds may assume about their environment.

It is also required to document what each value of the EAPI ebuild variable actually means. At present PMS aims to document all Council-approved EAPIs.

A git repository with the document's sources can be found at http://git.overlays.gentoo.org/gitweb/?p=proj/pms.git;a=summary. A convenient way to be up to date with the current document is the live ebuild found in the Gentoo repository, called app-doc/pms (TeX Live needs to be installed). Additionally, the latest approved version is available as ebuild of that package; it will either build from source, or (with the binary USE flag) install a pre-built PDF file.

Generated versions of the document

Here are links to generated PDF versions of the document to make it easier for some people to read it. Approved versions of the document will be here along with those considered of interest by the PMS editors.

Versions approved by the Gentoo Council
eapi-2-approved-2008-09-25 (PDF)
eapi-3-approved-2010-01-18 (HTML, PDF)
eapi-4-approved-2011-01-17 (HTML, PDF)
eapi-5-approved-2012-09-20 (HTML, PDF)
Current HEAD (might not be completely up to date)
PMS head (HTML, PDF, Cheat Sheet)

EAPI life cycle

EAPI approved Portage version stable deprecated comment
0 2.0.53 2005-12-26 2014-02-25 first Portage version aware of EAPI
1 2.1.3.19 2007-12-11 2013-04-09
2 2008-09-25 2.1.6.4 2009-01-08 2013-04-09
3 2010-01-18 2.1.7.17 2010-03-08 2014-02-25
4 2011-01-17 2.1.9.42 2011-03-17
5 2012-09-20 2.1.11.31 2012-12-11