From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id AD2D2138010 for ; Wed, 19 Sep 2012 18:07:00 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 887E321C032; Wed, 19 Sep 2012 18:06:48 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 48E6221C032 for ; Wed, 19 Sep 2012 18:06:48 +0000 (UTC) Received: from hornbill.gentoo.org (hornbill.gentoo.org [94.100.119.163]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 89F5933D107 for ; Wed, 19 Sep 2012 18:06:47 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id 4DFF3E5448 for ; Wed, 19 Sep 2012 18:06:46 +0000 (UTC) From: "Ulrich Mueller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Mueller" Message-ID: <1347954102.a9027f705630b21e6369c8add6da0944af674167.ulm@gentoo> Subject: [gentoo-commits] proj/pms:master commit in: / X-VCS-Repository: proj/pms X-VCS-Files: eapi-cheatsheet.tex X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Mueller X-VCS-Revision: a9027f705630b21e6369c8add6da0944af674167 X-VCS-Branch: master Date: Wed, 19 Sep 2012 18:06:46 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 15fe0e8c-680f-4685-8253-76cda58867b7 X-Archives-Hash: 0a8a85d89156126e25c127dc89363962 commit: a9027f705630b21e6369c8add6da0944af674167 Author: Ulrich Müller gentoo org> AuthorDate: Sun Sep 16 14:34:15 2012 +0000 Commit: Ulrich Mueller gentoo org> CommitDate: Tue Sep 18 07:41:42 2012 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/pms.git;a=commit;h=a9027f70 Add EAPI 5 to cheat sheet. --- eapi-cheatsheet.tex | 72 ++++++++++++++++++++++++++++++++++++++++++++++++++- 1 files changed, 71 insertions(+), 1 deletions(-) diff --git a/eapi-cheatsheet.tex b/eapi-cheatsheet.tex index 43a30dd..79d34cf 100644 --- a/eapi-cheatsheet.tex +++ b/eapi-cheatsheet.tex @@ -15,7 +15,7 @@ \usepackage[scaled=.90]{helvet} \newcommand{\code}[1]{\texttt{#1}} % This should reflect the latest approved EAPI version -\newcommand{\version}{4.0} +\newcommand{\version}{5.0} \newcommand{\featureref}[1]{\textsc{#1} on page~\pageref{feat:#1}} \renewcommand{\familydefault}{\sfdefault} \urlstyle{sf} @@ -245,6 +245,76 @@ If there is no EAPI explicitly specified, EAPI 0 is assumed. \item[\code{AA}, \code{KV}] These variables are not defined any more. See \featureref{aa} and \featureref{kv}. \end{description} + +\section{EAPI 5} +\label{sec:cs:eapi5} +\subsection{Additions/Changes} +\label{sec:cs:eapi5-additions} +\begin{description} + \item[Sub-slots] The \code{SLOT} variable and slot dependencies + may contain an optional sub-slot part that follows the regular + slot, delimited by a \code{/} character; for example + \code{2/2.30}. The sub-slot is used to represent cases in which + an upgrade to a new version of a package with a different sub-slot + may require dependent packages to be rebuilt. If the sub-slot is + not specified in \code{SLOT}, it defaults to the regular slot. + See \featureref{sub-slot}. + \item[Slot operator dependencies] One of the following operators + can be specified after package atoms, which will affect updates + of runtime dependencies: + \begin{description} + \item[\code{:*}] Any slot value is acceptable. The package + will not break when its dependency is updated. + \item[\code{:=}] Any slot value is acceptable, but the package + can break when its dependency is updated to a different slot + (or sub-slot). + \end{description} + See \featureref{slot-operator-deps}. + \item[Profile \code{IUSE} injection] Apart from the USE flags + explicitly listed in \code{IUSE}, additional flags can be + implicitly provided by profiles. + See \featureref{profile-iuse-inject}. + \item[At-most-one-of groups] In \code{REQUIRED\_USE} you can use + "\code{?? ( flag1 flag2 \dots\ )}" to allow zero or one USE flag + out of many. + See \featureref{at-most-one-of}. + \item[Parallel tests] The default for \code{src\_test} runs + \code{emake} without \code{-j1} now. + See \featureref{parallel-tests}. + \item[\code{econf} changes] The \code{econf} function now always + passes \code{-{}-disable-silent-rules} to \code{configure}. + See \featureref{econf-options}. + \item[\code{has\_version} and \code{best\_version} changes] + The two helpers support a \code{-{}-host-root} option that causes + the query to apply to the host root instead of \code{ROOT}. + See~\featureref{host-root-option}. + \item[\code{usex}] Usage for this helper function is + \code{usex} \emph{ [true1] [false1] [true2] [false2]}. + If the USE flag is set, outputs \emph{[true1][true2]} + (defaults to \code{yes}), otherwise outputs + \emph{[false1][false2]} (defaults to \code{no}). + See \featureref{usex}. + \item[\code{doheader} and \code{newheader}] These new helper + functions install the given header file(s) into + \code{/usr/include}. The \code{-r} option enables recursion for + \code{doheader}, similar to \code{doins}. + See \featureref{doheader}. + \item[\code{new*} standard input] The \code{newins} etc.\ commands + read from standard input if the first argument is \code{-} + (a hyphen). + See \featureref{newfoo-stdin}. + \item[\code{EBUILD\_PHASE\_FUNC}] This variable is very similar to + \code{EBUILD\_PHASE}, but contains the name of the current ebuild + function. + See \featureref{ebuild-phase-func}. + \item[Stable use masking/forcing] New files + \code{use.stable.\allowbreak\{mask,force\}} and + \code{package.use.stable.\allowbreak\{mask,force\}} + are supported in profile directories. They are similar to their + non-\code{stable} counterparts, but act only on packages that + would be merged due to a stable keyword. + See \featureref{stablemask}. +\end{description} \end{document} % vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :