Gentoo Archives: gentoo-pms

From: "Ulrich Müller" <ulm@g.o>
To: gentoo-pms@l.g.o
Cc: "Ulrich Müller" <ulm@g.o>
Subject: [gentoo-pms] [PATCH 2/3] Cheat sheet: Remove EAPI 5 to make room for EAPI 8
Date: Thu, 03 Jun 2021 08:31:24
Message-Id: 20210603083039.15440-3-ulm@gentoo.org
In Reply to: [gentoo-pms] EAPI cheat sheet for review by "Ulrich Müller"
1 Signed-off-by: Ulrich Müller <ulm@g.o>
2 ---
3 eapi-cheatsheet.tex | 140 ++++++++++++++++++++++----------------------
4 1 file changed, 70 insertions(+), 70 deletions(-)
5
6 diff --git a/eapi-cheatsheet.tex b/eapi-cheatsheet.tex
7 index fb62827..82602f2 100644
8 --- a/eapi-cheatsheet.tex
9 +++ b/eapi-cheatsheet.tex
10 @@ -77,7 +77,7 @@
11 \footnote{\url{https://creativecommons.org/licenses/by-sa/4.0/}}
12 \end{abstract}
13
14 -\section{EAPIs 0, 1, 2, 3, and 4}
15 +\section{EAPIs 0, 1, 2, 3, 4, and 5}
16 \label{sec:cs:eapi0-2}
17 Omitted for lack of space. See version~5.0 of this document for
18 differences between these previous EAPIs.
19 @@ -257,75 +257,75 @@ differences between these previous EAPIs.
20 % any more. See \featureref{aa} and \featureref{kv}.
21 % \end{description}
22
23 -\section{EAPI 5 (2012-09-20)}
24 -\label{sec:cs:eapi5}
25 -\subsection{Additions/Changes}
26 -\label{sec:cs:eapi5-additions}
27 -\begin{description}
28 - \item[Sub-slots] The \code{SLOT} variable and slot dependencies
29 - may contain an optional sub-slot part that follows the regular
30 - slot, delimited by a \code{/} character; for example
31 - \code{2/2.30}. The sub-slot is used to represent cases in which
32 - an upgrade to a new version of a package with a different sub-slot
33 - may require dependent packages to be rebuilt. If the sub-slot is
34 - not specified in \code{SLOT}, it defaults to the regular slot.
35 - See \featureref{sub-slot}.
36 - \item[Slot operator dependencies] Package dependencies can specify
37 - one of the following operators as a suffix, which will affect
38 - updates of runtime dependencies:
39 - \begin{description}
40 - \item[\code{:*}] Any slot value is acceptable. The package
41 - will not break when its dependency is updated.
42 - \item[\code{:=}] Any slot value is acceptable, but the package
43 - can break when its dependency is updated to a different slot
44 - (or sub-slot).
45 - \end{description}
46 - See \featureref{slot-operator-deps}.
47 - \item[Profile \code{IUSE} injection] Apart from the USE flags
48 - explicitly listed in \code{IUSE}, additional flags can be
49 - implicitly provided by profiles.
50 - See \featureref{profile-iuse-inject}.
51 - \item[At-most-one-of groups] In \code{REQUIRED_USE} you can use
52 - "\code{??\ ( flag1 flag2 \dots\ )}" to allow zero or one USE flag
53 - out of many.
54 - See \featureref{at-most-one-of}.
55 - \item[Parallel tests] The default for \code{src_test} runs
56 - \code{emake} without \code{-j1} now.
57 - See \featureref{parallel-tests}.
58 - \item[\code{econf} changes] The \code{econf} function now always
59 - passes \code{-{}-disable-silent-rules} to \code{configure}.
60 - See \featureref{econf-options}.
61 - \item[\code{has_version} and \code{best_version} changes]
62 - The two helpers support a \code{-{}-host-root} option that causes
63 - the query to apply to the host root instead of \code{ROOT}.
64 - See~\featureref{pm-query-options}.
65 - \item[\code{usex}] Usage for this helper function is
66 - \code{usex} \emph{<USE flag> [true1] [false1] [true2] [false2]}.
67 - If the USE flag is set, outputs \emph{[true1][true2]}
68 - (defaults to \code{yes}), otherwise outputs
69 - \emph{[false1][false2]} (defaults to \code{no}).
70 - See \featureref{usex}.
71 - \item[\code{doheader} and \code{newheader}] These new helper
72 - functions install the given header file(s) into
73 - \code{/usr/include}. The \code{-r} option enables recursion for
74 - \code{doheader}, similar to \code{doins}.
75 - See \featureref{doheader}.
76 - \item[\code{new*} standard input] The \code{newins} etc.\ commands
77 - read from standard input if the first argument is \code{-}
78 - (a hyphen).
79 - See \featureref{newfoo-stdin}.
80 - \item[\code{EBUILD_PHASE_FUNC}] This variable is very similar to
81 - \code{EBUILD_PHASE}, but contains the name of the current ebuild
82 - function.
83 - See \featureref{ebuild-phase-func}.
84 - \item[Stable use masking/forcing] New files
85 - \code{use.stable.\allowbreak\{mask,force\}} and
86 - \code{package.use.stable.\allowbreak\{mask,force\}}
87 - are supported in profile directories. They are similar to their
88 - non-\code{stable} counterparts, but act only on packages that
89 - would be merged due to a stable keyword.
90 - See \featureref{stablemask}.
91 -\end{description}
92 +% \section{EAPI 5 (2012-09-20)}
93 +% \label{sec:cs:eapi5}
94 +% \subsection{Additions/Changes}
95 +% \label{sec:cs:eapi5-additions}
96 +% \begin{description}
97 +% \item[Sub-slots] The \code{SLOT} variable and slot dependencies
98 +% may contain an optional sub-slot part that follows the regular
99 +% slot, delimited by a \code{/} character; for example
100 +% \code{2/2.30}. The sub-slot is used to represent cases in which
101 +% an upgrade to a new version of a package with a different sub-slot
102 +% may require dependent packages to be rebuilt. If the sub-slot is
103 +% not specified in \code{SLOT}, it defaults to the regular slot.
104 +% See \featureref{sub-slot}.
105 +% \item[Slot operator dependencies] Package dependencies can specify
106 +% one of the following operators as a suffix, which will affect
107 +% updates of runtime dependencies:
108 +% \begin{description}
109 +% \item[\code{:*}] Any slot value is acceptable. The package
110 +% will not break when its dependency is updated.
111 +% \item[\code{:=}] Any slot value is acceptable, but the package
112 +% can break when its dependency is updated to a different slot
113 +% (or sub-slot).
114 +% \end{description}
115 +% See \featureref{slot-operator-deps}.
116 +% \item[Profile \code{IUSE} injection] Apart from the USE flags
117 +% explicitly listed in \code{IUSE}, additional flags can be
118 +% implicitly provided by profiles.
119 +% See \featureref{profile-iuse-inject}.
120 +% \item[At-most-one-of groups] In \code{REQUIRED_USE} you can use
121 +% "\code{??\ ( flag1 flag2 \dots\ )}" to allow zero or one USE flag
122 +% out of many.
123 +% See \featureref{at-most-one-of}.
124 +% \item[Parallel tests] The default for \code{src_test} runs
125 +% \code{emake} without \code{-j1} now.
126 +% See \featureref{parallel-tests}.
127 +% \item[\code{econf} changes] The \code{econf} function now always
128 +% passes \code{-{}-disable-silent-rules} to \code{configure}.
129 +% See \featureref{econf-options}.
130 +% \item[\code{has_version} and \code{best_version} changes]
131 +% The two helpers support a \code{-{}-host-root} option that causes
132 +% the query to apply to the host root instead of \code{ROOT}.
133 +% See~\featureref{pm-query-options}.
134 +% \item[\code{usex}] Usage for this helper function is
135 +% \code{usex} \emph{<USE flag> [true1] [false1] [true2] [false2]}.
136 +% If the USE flag is set, outputs \emph{[true1][true2]}
137 +% (defaults to \code{yes}), otherwise outputs
138 +% \emph{[false1][false2]} (defaults to \code{no}).
139 +% See \featureref{usex}.
140 +% \item[\code{doheader} and \code{newheader}] These new helper
141 +% functions install the given header file(s) into
142 +% \code{/usr/include}. The \code{-r} option enables recursion for
143 +% \code{doheader}, similar to \code{doins}.
144 +% See \featureref{doheader}.
145 +% \item[\code{new*} standard input] The \code{newins} etc.\ commands
146 +% read from standard input if the first argument is \code{-}
147 +% (a hyphen).
148 +% See \featureref{newfoo-stdin}.
149 +% \item[\code{EBUILD_PHASE_FUNC}] This variable is very similar to
150 +% \code{EBUILD_PHASE}, but contains the name of the current ebuild
151 +% function.
152 +% See \featureref{ebuild-phase-func}.
153 +% \item[Stable use masking/forcing] New files
154 +% \code{use.stable.\allowbreak\{mask,force\}} and
155 +% \code{package.use.stable.\allowbreak\{mask,force\}}
156 +% are supported in profile directories. They are similar to their
157 +% non-\code{stable} counterparts, but act only on packages that
158 +% would be merged due to a stable keyword.
159 +% See \featureref{stablemask}.
160 +% \end{description}
161
162 \section{EAPI 6 (2015-11-13)}
163 \label{sec:cs:eapi6}
164 --
165 2.31.1