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 02/21] EAPI feature table: Consolidate EAPIs 0 to 4
Date: Thu, 27 May 2021 20:26:49
Message-Id: 20210527202609.6445-3-ulm@gentoo.org
In Reply to: [gentoo-pms] EAPI 8 draft for review by "Ulrich Müller"
1 Signed-off-by: Ulrich Müller <ulm@g.o>
2 ---
3 eapi-differences.tex | 191 +++++++++++++++++++++----------------------
4 1 file changed, 93 insertions(+), 98 deletions(-)
5
6 diff --git a/eapi-differences.tex b/eapi-differences.tex
7 index d5513c3..38109ec 100644
8 --- a/eapi-differences.tex
9 +++ b/eapi-differences.tex
10 @@ -1,23 +1,22 @@
11 \chapter{Feature Availability by EAPI}
12
13 \note{This chapter is informative and for convenience only. Refer to the main text for specifics.
14 -For lack of space, EAPIs 0, 1, 2, and~3 have been consolidated into a single column in the table
15 +For lack of space, EAPIs 0, 1, 2, 3, and~4 have been consolidated into a single column in the table
16 below; entries marked with an asterisk differ between these EAPIs. See the 2012-09-20 edition
17 of this document for a complete table of previous EAPIs.}
18 % 2012-09-20 (EAPI 5) edition has a table of EAPIs 0 to 5
19
20 \ChangeWhenAddingAnEAPI{8}
21 \begin{landscape}
22 -\begin{longtable}{llP{7.5em}P{7.5em}P{7.5em}P{7.5em}P{7.5em}P{7.5em}}
23 +\begin{longtable}{llP{7.5em}P{7.5em}P{7.5em}P{7.5em}P{7.5em}}
24 \caption{Features in EAPIs}\\
25 \toprule
26 \multicolumn{1}{c}{\textbf{Feature}} &
27 \multicolumn{1}{c}{\textbf{Reference}} &
28 -\multicolumn{6}{c}{\textbf{EAPIs}} \\
29 +\multicolumn{5}{c}{\textbf{EAPIs}} \\
30 \multicolumn{1}{c}{} &
31 \multicolumn{1}{c}{} &
32 -\multicolumn{1}{c}{0, 1, 2, 3} &
33 -\multicolumn{1}{c}{4} &
34 +\multicolumn{1}{c}{0, 1, 2, 3, 4} &
35 \multicolumn{1}{c}{5} &
36 \multicolumn{1}{c}{6} &
37 \multicolumn{1}{c}{7} &
38 @@ -27,11 +26,10 @@ of this document for a complete table of previous EAPIs.}
39 \midrule
40 \multicolumn{1}{c}{\textbf{Feature}} &
41 \multicolumn{1}{c}{\textbf{Reference}} &
42 -\multicolumn{6}{c}{\textbf{EAPIs}} \\
43 +\multicolumn{5}{c}{\textbf{EAPIs}} \\
44 \multicolumn{1}{c}{} &
45 \multicolumn{1}{c}{} &
46 -\multicolumn{1}{c}{0, 1, 2, 3} &
47 -\multicolumn{1}{c}{4} &
48 +\multicolumn{1}{c}{0, 1, 2, 3, 4} &
49 \multicolumn{1}{c}{5} &
50 \multicolumn{1}{c}{6} &
51 \multicolumn{1}{c}{7} &
52 @@ -44,92 +42,92 @@ of this document for a complete table of previous EAPIs.}
53 \endlastfoot
54
55 \t{package.mask} directory & \compactfeatureref{package-mask-dir} &
56 - No & No & No & No & Yes & Yes \\
57 + No & No & No & Yes & Yes \\
58
59 Profile files as directories & \compactfeatureref{profile-file-dirs} &
60 - No & No & No & No & Yes & Yes \\
61 + No & No & No & Yes & Yes \\
62
63 \t{package.provided} & \compactfeatureref{package-provided} &
64 - Optional & Optional & Optional & Optional & No & No \\
65 + Optional & Optional & Optional & No & No \\
66
67 Stable use masking/forcing & \compactfeatureref{stablemask} &
68 - No & No & Yes & Yes & Yes & Yes \\
69 + No & Yes & Yes & Yes & Yes \\
70
71 Bash version & \compactfeatureref{bash-version} &
72 - 3.2 & 3.2 & 3.2 & 4.2 & 4.2 & 4.2 \\
73 + 3.2 & 3.2 & 4.2 & 4.2 & 4.2 \\
74
75 \t{failglob} in global scope & \compactfeatureref{failglob} &
76 - No & No & No & Yes & Yes & Yes \\
77 + No & No & Yes & Yes & Yes \\
78
79 \t{IUSE} defaults & \compactfeatureref{iuse-defaults} &
80 - * & Yes & Yes & Yes & Yes & Yes \\
81 + * & Yes & Yes & Yes & Yes \\
82
83 \t{REQUIRED_USE} & \compactfeatureref{required-use} &
84 - No & Yes & Yes & Yes & Yes & Yes \\
85 + * & Yes & Yes & Yes & Yes \\
86
87 \t{PROPERTIES} & \compactfeatureref{properties} &
88 - Optionally & Yes & Yes & Yes & Yes & Yes \\
89 + * & Yes & Yes & Yes & Yes \\
90
91 \t{SRC_URI} arrows & \compactfeatureref{src-uri-arrows} &
92 - * & Yes & Yes & Yes & Yes & Yes \\
93 + * & Yes & Yes & Yes & Yes \\
94
95 \t{RDEPEND=DEPEND} & \compactfeatureref{rdepend-depend} &
96 - Yes & No & No & No & No & No \\
97 + * & No & No & No & No \\
98
99 \t{DEFINED_PHASES} & \compactfeatureref{defined-phases} &
100 - Optionally & Yes & Yes & Yes & Yes & Yes \\
101 + * & Yes & Yes & Yes & Yes \\
102
103 \t{BDEPEND} & \compactfeatureref{bdepend} &
104 - No & No & No & No & Yes & Yes \\
105 + No & No & No & Yes & Yes \\
106
107 \t{??\ ( )} groups & \compactfeatureref{at-most-one-of} &
108 - No & No & Yes & Yes & Yes & Yes \\
109 + No & Yes & Yes & Yes & Yes \\
110
111 Empty \t{||}, \t{\textasciicircum\textasciicircum} groups match &
112 \compactfeatureref{empty-dep-groups} &
113 - Yes & Yes & Yes & Yes & No & No \\
114 + Yes & Yes & Yes & No & No \\
115
116 Slot dependencies & \compactfeatureref{slot-deps} &
117 - * & Named & Named and Operator & Named and Operator & Named and Operator & Named and Operator \\
118 + * & Named and Operator & Named and Operator & Named and Operator & Named and Operator \\
119
120 Sub-slots & \compactfeatureref{sub-slot} &
121 - No & No & Yes & Yes & Yes & Yes \\
122 + No & Yes & Yes & Yes & Yes \\
123
124 Use dependencies & \compactfeatureref{use-deps} &
125 - * & 4-style & 4-style & 4-style & 4-style & 4-style \\
126 + * & 4-style & 4-style & 4-style & 4-style \\
127
128 \t{!}\ blockers & \compactfeatureref{bang-strength} &
129 - * & Weak & Weak & Weak & Weak & Weak \\
130 + * & Weak & Weak & Weak & Weak \\
131
132 \t{!!}\ blockers & \compactfeatureref{bang-strength} &
133 - * & Strong & Strong & Strong & Strong & Strong \\
134 + * & Strong & Strong & Strong & Strong \\
135
136 \t{S} to \t{WORKDIR} fallback & \compactfeatureref{s-workdir-fallback} &
137 - Always & Conditional & Conditional & Conditional & Conditional & Conditional \\
138 + * & Conditional & Conditional & Conditional & Conditional \\
139
140 \t{pkg_pretend} & \compactfeatureref{pkg-pretend} &
141 - No & Yes & Yes & Yes & Yes & Yes \\
142 + * & Yes & Yes & Yes & Yes \\
143
144 \t{src_prepare} & \compactfeatureref{src-prepare} &
145 - * & Yes & Yes & Yes & Yes & Yes \\
146 + * & Yes & Yes & Yes & Yes \\
147
148 \t{src_prepare} style & \compactfeatureref{src-prepare} &
149 - * & no-op & no-op & 6 & 6 & 6 \\
150 + * & no-op & 6 & 6 & 6 \\
151
152 \t{src_configure} & \compactfeatureref{src-configure} &
153 - * & Yes & Yes & Yes & Yes & Yes \\
154 + * & Yes & Yes & Yes & Yes \\
155
156 \t{src_compile} style & \compactfeatureref{src-compile} &
157 - * & 2 & 2 & 2 & 2 & 2 \\
158 + * & 2 & 2 & 2 & 2 \\
159
160 Parallel tests & \compactfeatureref{parallel-tests} &
161 - No & No & Yes & Yes & Yes & Yes \\
162 + No & Yes & Yes & Yes & Yes \\
163
164 \t{src_install} style & \compactfeatureref{src-install} &
165 - no-op & 4 & 4 & 6 & 6 & 6 \\
166 + * & 4 & 6 & 6 & 6 \\
167
168 \t{pkg_info} & \compactfeatureref{pkg-info} &
169 - Installed & Both & Both & Both & Both & Both \\
170 + * & Both & Both & Both & Both \\
171
172 \t{default_} phase functions & \compactfeatureref{default-phase-funcs} &
173 * &
174 @@ -139,190 +137,187 @@ Parallel tests & \compactfeatureref{parallel-tests} &
175 \t{src_compile}, \t{src_test}, \t{src_install} &
176 \t{pkg_nofetch}, \t{src_unpack}, \t{src_prepare}, \t{src_configure},
177 \t{src_compile}, \t{src_test}, \t{src_install} &
178 - \t{pkg_nofetch}, \t{src_unpack}, \t{src_prepare}, \t{src_configure},
179 - \t{src_compile}, \t{src_test}, \t{src_install} &
180 \t{pkg_nofetch}, \t{src_unpack}, \t{src_prepare}, \t{src_configure},
181 \t{src_compile}, \t{src_test}, \t{src_install} \\
182
183 \t{AA} & \compactfeatureref{aa} &
184 - Yes & No & No & No & No & No \\
185 + * & No & No & No & No \\
186
187 \t{PORTDIR} & \compactfeatureref{portdir} &
188 - Yes & Yes & Yes & Yes & No & No \\
189 + Yes & Yes & Yes & No & No \\
190
191 \t{ECLASSDIR} & \compactfeatureref{eclassdir} &
192 - Yes & Yes & Yes & Yes & No & No \\
193 + Yes & Yes & Yes & No & No \\
194
195 \t{SYSROOT}, \t{ESYSROOT} & \compactfeatureref{sysroot} &
196 - No & No & No & No & Yes & Yes \\
197 + No & No & No & Yes & Yes \\
198
199 \t{BROOT} & \compactfeatureref{broot} &
200 - No & No & No & No & Yes & Yes \\
201 + No & No & No & Yes & Yes \\
202
203 \t{DESTTREE} & \compactfeatureref{desttree} &
204 - Yes & Yes & Yes & Yes & No & No \\
205 + Yes & Yes & Yes & No & No \\
206
207 \t{INSDESTTREE} & \compactfeatureref{insdesttree} &
208 - Yes & Yes & Yes & Yes & No & No \\
209 + Yes & Yes & Yes & No & No \\
210
211 \t{KV} & \compactfeatureref{kv} &
212 - Yes & No & No & No & No & No \\
213 + * & No & No & No & No \\
214
215 \t{EBUILD_PHASE_FUNC} & \compactfeatureref{ebuild-phase-func} &
216 - No & No & Yes & Yes & Yes & Yes \\
217 + No & Yes & Yes & Yes & Yes \\
218
219 \t{MERGE_TYPE} & \compactfeatureref{merge-type} &
220 - No & Yes & Yes & Yes & Yes & Yes \\
221 + * & Yes & Yes & Yes & Yes \\
222
223 \t{ENV_UNSET} & \compactfeatureref{env-unset} &
224 - No & No & No & No & Yes & Yes \\
225 + No & No & No & Yes & Yes \\
226
227 Sane locale settings & \compactfeatureref{locale-settings} &
228 - Undefined & Undefined & Undefined & Yes & Yes & Yes \\
229 + Undefined & Undefined & Yes & Yes & Yes \\
230
231 Profile \t{IUSE} injection & \compactfeatureref{profile-iuse-inject} &
232 - No & No & Yes & Yes & Yes & Yes \\
233 + No & Yes & Yes & Yes & Yes \\
234
235 \t{REPLACING_VERSIONS} & \compactfeatureref{replace-version-vars} &
236 - No & Yes & Yes & Yes & Yes & Yes \\
237 + * & Yes & Yes & Yes & Yes \\
238
239 \t{REPLACED_BY_VERSION} & \compactfeatureref{replace-version-vars} &
240 - No & Yes & Yes & Yes & Yes & Yes \\
241 + * & Yes & Yes & Yes & Yes \\
242
243 \t{EPREFIX}, \t{ED}, \t{EROOT} & \compactfeatureref{offset-prefix-vars} &
244 - * & Yes & Yes & Yes & Yes & Yes \\
245 + * & Yes & Yes & Yes & Yes \\
246
247 Trailing slash in \t{D} etc. & \compactfeatureref{trailing-slash} &
248 - Yes & Yes & Yes & Yes & No & No \\
249 + Yes & Yes & Yes & No & No \\
250
251 GNU \t{patch} version & \compactfeatureref{gnu-patch} &
252 - Any & Any & Any & Any & 2.7 & 2.7 \\
253 + Any & Any & Any & 2.7 & 2.7 \\
254
255 \t{find} is GNU? & \compactfeatureref{gnu-find} &
256 - Undefined & Undefined & Yes & Yes & Yes & Yes \\
257 + Undefined & Yes & Yes & Yes & Yes \\
258
259 Most utilities die & \compactfeatureref{die-on-failure} &
260 - No & Yes & Yes & Yes & Yes & Yes \\
261 + * & Yes & Yes & Yes & Yes \\
262
263 \t{nonfatal} & \compactfeatureref{nonfatal} &
264 - No & Yes & Yes & Yes & Function / external & Function / external \\
265 + * & Yes & Yes & Function / external & Function / external \\
266
267 \t{dohard} & \compactfeatureref{banned-commands} &
268 - Yes & Banned & Banned & Banned & Banned & Banned \\
269 + * & Banned & Banned & Banned & Banned \\
270
271 \t{dosed} & \compactfeatureref{banned-commands} &
272 - Yes & Banned & Banned & Banned & Banned & Banned \\
273 + * & Banned & Banned & Banned & Banned \\
274
275 \t{einstall} & \compactfeatureref{banned-commands} &
276 - Yes & Yes & Yes & Banned & Banned & Banned \\
277 + Yes & Yes & Banned & Banned & Banned \\
278
279 \t{dohtml} & \compactfeatureref{banned-commands} &
280 - Yes & Yes & Yes & Yes & Banned & Banned \\
281 + Yes & Yes & Yes & Banned & Banned \\
282
283 \t{dolib} & \compactfeatureref{banned-commands} &
284 - Yes & Yes & Yes & Yes & Banned & Banned \\
285 + Yes & Yes & Yes & Banned & Banned \\
286
287 \t{libopts} & \compactfeatureref{banned-commands} &
288 - Yes & Yes & Yes & Yes & Banned & Banned \\
289 + Yes & Yes & Yes & Banned & Banned \\
290
291 Query command options & \compactfeatureref{pm-query-options} &
292 - None & None & \t{-{}-host-root} & \t{-{}-host-root} & \t{-b}, \t{-d}, \t{-r} &
293 + None & \t{-{}-host-root} & \t{-{}-host-root} & \t{-b}, \t{-d}, \t{-r} &
294 \t{-b}, \t{-d}, \t{-r} \\
295
296 Output commands use stdout & \compactfeatureref{output-no-stdout} &
297 - Yes & Yes & Yes & Yes & No & No \\
298 + Yes & Yes & Yes & No & No \\
299
300 \t{eqawarn} & \compactfeatureref{eqawarn} &
301 - No & No & No & No & Yes & Yes \\
302 + No & No & No & Yes & Yes \\
303
304 \t{die -n} & \compactfeatureref{nonfatal-die} &
305 - No & No & No & Yes & Yes & Yes \\
306 + No & No & Yes & Yes & Yes \\
307
308 \t{die} in subshell & \compactfeatureref{subshell-die} &
309 - No & No & No & No & Yes & Yes \\
310 + No & No & No & Yes & Yes \\
311
312 \t{eapply} & \compactfeatureref{eapply} &
313 - No & No & No & Yes & Yes & Yes \\
314 + No & No & Yes & Yes & Yes \\
315
316 \t{eapply_user} & \compactfeatureref{eapply-user} &
317 - No & No & No & Yes & Yes & Yes \\
318 + No & No & Yes & Yes & Yes \\
319
320 \t{econf} arguments & \compactfeatureref{econf-options} &
321 - None & disable dependency tracking &
322 + * &
323 disable dependency tracking, disable silent rules &
324 disable dependency tracking, disable silent rules, docdir, htmldir &
325 disable dependency tracking, disable silent rules, docdir, htmldir, with sysroot &
326 disable dependency tracking, disable silent rules, docdir, htmldir, with sysroot \\
327
328 \t{dodoc -r} & \compactfeatureref{dodoc} &
329 - No & Yes & Yes & Yes & Yes & Yes \\
330 + * & Yes & Yes & Yes & Yes \\
331
332 \t{doheader} & \compactfeatureref{doheader} &
333 - No & No & Yes & Yes & Yes & Yes \\
334 + No & Yes & Yes & Yes & Yes \\
335
336 \t{doins} handles symlinks & \compactfeatureref{doins} &
337 - No & Yes & Yes & Yes & Yes & Yes \\
338 + * & Yes & Yes & Yes & Yes \\
339
340 \t{doman} languages & \compactfeatureref{doman-langs} &
341 - * & Yes & Yes & Yes & Yes & Yes \\
342 + * & Yes & Yes & Yes & Yes \\
343
344 \t{doman -i18n} precedence & \compactfeatureref{doman-langs} &
345 - * & Yes & Yes & Yes & Yes & Yes \\
346 + * & Yes & Yes & Yes & Yes \\
347
348 \t{domo} destination path & \compactfeatureref{domo-path} &
349 - \t{\$\{DESTTREE\}} & \t{\$\{DESTTREE\}} & \t{\$\{DESTTREE\}} & \t{\$\{DESTTREE\}} & \t{/usr} &
350 - \t{/usr} \\
351 + \t{\$\{DESTTREE\}} & \t{\$\{DESTTREE\}} & \t{\$\{DESTTREE\}} & \t{/usr} & \t{/usr} \\
352
353 \t{new*} support stdin & \compactfeatureref{newfoo-stdin} &
354 - No & No & Yes & Yes & Yes & Yes \\
355 + No & Yes & Yes & Yes & Yes \\
356
357 Controllable compression & \compactfeatureref{docompress} &
358 - No & Yes & Yes & Yes & Yes & Yes \\
359 + * & Yes & Yes & Yes & Yes \\
360
361 \t{docompress} & \compactfeatureref{docompress} &
362 - No & Yes & Yes & Yes & Yes & Yes \\
363 + * & Yes & Yes & Yes & Yes \\
364
365 Controllable stripping & \compactfeatureref{dostrip} &
366 - No & No & No & No & Yes & Yes \\
367 + No & No & No & Yes & Yes \\
368
369 \t{dostrip} & \compactfeatureref{dostrip} &
370 - No & No & No & No & Yes & Yes \\
371 + No & No & No & Yes & Yes \\
372
373 \t{use_with} empty third arg & \compactfeatureref{use-with} &
374 - No & Yes & Yes & Yes & Yes & Yes \\
375 + * & Yes & Yes & Yes & Yes \\
376
377 \t{usex} & \compactfeatureref{usex} &
378 - No & No & Yes & Yes & Yes & Yes \\
379 + No & Yes & Yes & Yes & Yes \\
380
381 \t{in_iuse} & \compactfeatureref{in-iuse} &
382 - No & No & No & Yes & Yes & Yes \\
383 + No & No & Yes & Yes & Yes \\
384
385 \t{ver_*} commands & \compactfeatureref{ver-commands} &
386 - No & No & No & No & Yes & Yes \\
387 + No & No & No & Yes & Yes \\
388
389 \t{unpack} absolute paths & \compactfeatureref{unpack-absolute} &
390 - No & No & No & Yes & Yes & Yes \\
391 + No & No & Yes & Yes & Yes \\
392
393 \t{unpack} support for \t{xz} & \compactfeatureref{unpack-extensions} &
394 - * & Yes & Yes & Yes & Yes & Yes \\
395 + * & Yes & Yes & Yes & Yes \\
396
397 \t{unpack} support for \t{txz} & \compactfeatureref{unpack-extensions} &
398 - No & No & No & Yes & Yes & Yes \\
399 + No & No & Yes & Yes & Yes \\
400
401 \t{unpack} case-insensitive & \compactfeatureref{unpack-ignore-case} &
402 - No & No & No & Yes & Yes & Yes \\
403 + No & No & Yes & Yes & Yes \\
404
405 \t{default} function & \compactfeatureref{default-func} &
406 - * & Yes & Yes & Yes & Yes & Yes \\
407 + * & Yes & Yes & Yes & Yes \\
408
409 \t{einstalldocs} & \compactfeatureref{einstalldocs} &
410 - No & No & No & Yes & Yes & Yes \\
411 + No & No & Yes & Yes & Yes \\
412
413 \t{get_libdir} & \compactfeatureref{get-libdir} &
414 - No & No & No & Yes & Yes & Yes \\
415 + No & No & Yes & Yes & Yes \\
416
417 File mtimes preserved & \compactfeatureref{mtime-preserve} &
418 - * & Yes & Yes & Yes & Yes & Yes \\
419 + * & Yes & Yes & Yes & Yes \\
420
421 \end{longtable}
422 \end{landscape}
423 --
424 2.31.1