Gentoo Archives: gentoo-pms

From: "Ulrich Müller" <ulm@g.o>
To: gentoo-pms@l.g.o
Subject: [gentoo-pms] [PATCH 02/22] Rework the EAPI feature table.
Date: Thu, 15 Oct 2015 10:50:34
Message-Id: 1444906221-30505-3-git-send-email-ulm@gentoo.org
In Reply to: [gentoo-pms] EAPI 6 draft for review by "Ulrich Müller"
1 With the addition of EAPI 6, the table was too wide for the page, even
2 in landscape mode. Therefore, consolidate EAPIs 0, 1, and 2 into one
3 single column, and add a reference to the 2012-09-20 edition (EAPI 5)
4 which contains the complete table for these EAPIs.
5 ---
6 eapi-differences.tex | 117 +++++++++++++++++++++++++--------------------------
7 1 file changed, 58 insertions(+), 59 deletions(-)
8
9 diff --git a/eapi-differences.tex b/eapi-differences.tex
10 index 0a8f9e1..c28494d 100644
11 --- a/eapi-differences.tex
12 +++ b/eapi-differences.tex
13 @@ -1,11 +1,14 @@
14 \chapter{Feature Availability by EAPI}
15
16 \note This chapter is informative and for convenience only. Refer to the main text for specifics.
17 +For lack of space, EAPIs 0, 1, and~2 have been consolidated into a single column in the table
18 +below; entries marked with an asterisk differ between these EAPIs. See the 2012-09-20 edition
19 +of this document for a complete table of previous EAPIs.
20
21 \ChangeWhenAddingAnEAPI{6}
22 \begin{landscape}
23 \newcolumntype{P}[1]{>{\setlength{\rightskip}{0pt plus 1fil}}p{#1}}
24 -\begin{longtable}{llP{5em}P{5em}P{6em}P{6em}P{6em}P{6em}P{6em}}
25 +\begin{longtable}{llP{7.5em}P{7.5em}P{7.5em}P{7.5em}P{7.5em}}
26 \caption{Features in EAPIs}\\
27 \toprule
28 \multicolumn{1}{c}{\b{Feature}} &
29 @@ -13,9 +16,7 @@
30 \multicolumn{4}{c}{\b{EAPIs}} \\
31 \multicolumn{1}{c}{} &
32 \multicolumn{1}{c}{} &
33 -\multicolumn{1}{c}{0} &
34 -\multicolumn{1}{c}{1} &
35 -\multicolumn{1}{c}{2} &
36 +\multicolumn{1}{c}{0, 1, 2} &
37 \multicolumn{1}{c}{3} &
38 \multicolumn{1}{c}{4} &
39 \multicolumn{1}{c}{5} &
40 @@ -28,9 +29,7 @@
41 \multicolumn{4}{c}{\b{EAPIs}} \\
42 \multicolumn{1}{c}{} &
43 \multicolumn{1}{c}{} &
44 -\multicolumn{1}{c}{0} &
45 -\multicolumn{1}{c}{1} &
46 -\multicolumn{1}{c}{2} &
47 +\multicolumn{1}{c}{0, 1, 2} &
48 \multicolumn{1}{c}{3} &
49 \multicolumn{1}{c}{4} &
50 \multicolumn{1}{c}{5} &
51 @@ -43,72 +42,72 @@
52 \endlastfoot
53
54 Stable use masking/forcing & \compactfeatureref{stablemask} &
55 - No & No & No & No & No & Yes & Yes \\
56 + No & No & No & Yes & Yes \\
57
58 \t{IUSE} defaults & \compactfeatureref{iuse-defaults} &
59 - No & Yes & Yes & Yes & Yes & Yes & Yes \\
60 + * & Yes & Yes & Yes & Yes \\
61
62 \t{REQUIRED\_USE} & \compactfeatureref{required-use} &
63 - No & No & No & No & Yes & Yes & Yes \\
64 + No & No & Yes & Yes & Yes \\
65
66 \t{PROPERTIES} & \compactfeatureref{properties} &
67 - Optionally & Optionally & Optionally & Optionally & Yes & Yes & Yes \\
68 + Optionally & Optionally & Yes & Yes & Yes \\
69
70 \t{RDEPEND=DEPEND} & \compactfeatureref{rdepend-depend} &
71 - Yes & Yes & Yes & Yes & No & No & No \\
72 + Yes & Yes & No & No & No \\
73
74 \t{DEFINED\_PHASES} & \compactfeatureref{defined-phases} &
75 - Optionally & Optionally & Optionally & Optionally & Yes & Yes & Yes \\
76 + Optionally & Optionally & Yes & Yes & Yes \\
77
78 \t{??\ ( )} groups & \compactfeatureref{at-most-one-of} &
79 - No & No & No & No & No & Yes & Yes \\
80 + No & No & No & Yes & Yes \\
81
82 \t{SRC\_URI} arrows & \compactfeatureref{src-uri-arrows} &
83 - No & No & Yes & Yes & Yes & Yes & Yes \\
84 + * & Yes & Yes & Yes & Yes \\
85
86 Slot dependencies & \compactfeatureref{slot-deps} &
87 - No & Named & Named & Named & Named & Named and Operator & Named and Operator \\
88 + * & Named & Named & Named and Operator & Named and Operator \\
89
90 Sub-slots & \compactfeatureref{sub-slot} &
91 - No & No & No & No & No & Yes & Yes \\
92 + No & No & No & Yes & Yes \\
93
94 Use dependencies & \compactfeatureref{use-deps} &
95 - No & No & 2-style & 2-style & 4-style & 4-style & 4-style \\
96 + * & 2-style & 4-style & 4-style & 4-style \\
97
98 \t{!} blockers & \compactfeatureref{bang-strength} &
99 - Unspecified & Unspecified & Weak & Weak & Weak & Weak & Weak \\
100 + * & Weak & Weak & Weak & Weak \\
101
102 \t{!!} blockers & \compactfeatureref{bang-strength} &
103 - Forbidden & Forbidden & Strong & Strong & Strong & Strong & Strong \\
104 + * & Strong & Strong & Strong & Strong \\
105
106 \t{S} to \t{WORKDIR} fallback & \compactfeatureref{s-workdir-fallback} &
107 - Always & Always & Always & Always & Conditional & Conditional & Conditional \\
108 + Always & Always & Conditional & Conditional & Conditional \\
109
110 \t{pkg\_pretend} & \compactfeatureref{pkg-pretend} &
111 - No & No & No & No & Yes & Yes & Yes \\
112 + No & No & Yes & Yes & Yes \\
113
114 \t{src\_prepare} & \compactfeatureref{src-prepare} &
115 - No & No & Yes & Yes & Yes & Yes & Yes \\
116 + * & Yes & Yes & Yes & Yes \\
117
118 \t{src\_configure} & \compactfeatureref{src-configure} &
119 - No & No & Yes & Yes & Yes & Yes & Yes \\
120 + * & Yes & Yes & Yes & Yes \\
121
122 \t{src\_compile} style & \compactfeatureref{src-compile} &
123 - 0 & 1 & 2 & 2 & 2 & 2 & 2 \\
124 + * & 2 & 2 & 2 & 2 \\
125
126 Parallel tests & \compactfeatureref{parallel-tests} &
127 - No & No & No & No & No & Yes & Yes \\
128 + No & No & No & Yes & Yes \\
129
130 \t{src\_install} style & \compactfeatureref{src-install} &
131 - no-op & no-op & no-op & no-op & 4 & 4 & 4 \\
132 + no-op & no-op & 4 & 4 & 4 \\
133
134 \t{pkg\_info} & \compactfeatureref{pkg-info} &
135 - Installed & Installed & Installed & Installed & Both & Both & Both \\
136 + Installed & Installed & Both & Both & Both \\
137
138 \t{default\_} phase functions & \compactfeatureref{default-phase-funcs} &
139 - None & None &
140 - \t{pkg\_nofetch}, \t{src\_unpack}, \t{src\_prepare}, \t{src\_configure}, \t{src\_compile}, \t{src\_test} &
141 - \t{pkg\_nofetch}, \t{src\_unpack}, \t{src\_prepare}, \t{src\_configure}, \t{src\_compile}, \t{src\_test} &
142 + * &
143 + \t{pkg\_nofetch}, \t{src\_unpack}, \t{src\_prepare}, \t{src\_configure},
144 + \t{src\_compile}, \t{src\_test} &
145 \t{pkg\_nofetch}, \t{src\_unpack}, \t{src\_prepare}, \t{src\_configure},
146 \t{src\_compile}, \t{src\_install}, \t{src\_test} &
147 \t{pkg\_nofetch}, \t{src\_unpack}, \t{src\_prepare}, \t{src\_configure},
148 @@ -117,90 +116,90 @@ Parallel tests & \compactfeatureref{parallel-tests} &
149 \t{src\_compile}, \t{src\_install}, \t{src\_test} \\
150
151 \t{AA} & \compactfeatureref{aa} &
152 - Yes & Yes & Yes & Yes & No & No & No \\
153 + Yes & Yes & No & No & No \\
154
155 \t{KV} & \compactfeatureref{kv} &
156 - Yes & Yes & Yes & Yes & No & No & No \\
157 + Yes & Yes & No & No & No \\
158
159 \t{EBUILD\_PHASE\_FUNC} & \compactfeatureref{ebuild-phase-func} &
160 - No & No & No & No & No & Yes & Yes \\
161 + No & No & No & Yes & Yes \\
162
163 \t{MERGE\_TYPE} & \compactfeatureref{merge-type} &
164 - No & No & No & No & Yes & Yes & Yes \\
165 + No & No & Yes & Yes & Yes \\
166
167 Profile \t{IUSE} injection & \compactfeatureref{profile-iuse-inject} &
168 - No & No & No & No & No & Yes & Yes \\
169 + No & No & No & Yes & Yes \\
170
171 \t{REPLACING\_VERSIONS} & \compactfeatureref{replace-version-vars} &
172 - No & No & No & No & Yes & Yes & Yes \\
173 + No & No & Yes & Yes & Yes \\
174
175 \t{REPLACED\_BY\_VERSION} & \compactfeatureref{replace-version-vars} &
176 - No & No & No & No & Yes & Yes & Yes \\
177 + No & No & Yes & Yes & Yes \\
178
179 \t{EPREFIX}, \t{ED}, \t{EROOT} & \compactfeatureref{offset-prefix-vars} &
180 - No & No & No & Yes & Yes & Yes & Yes \\
181 + No & Yes & Yes & Yes & Yes \\
182
183 \t{find} is GNU? & \compactfeatureref{gnu-find} &
184 - Undefined & Undefined & Undefined & Undefined & Undefined & Yes & Yes \\
185 + Undefined & Undefined & Undefined & Yes & Yes \\
186
187 Most utilities die & \compactfeatureref{die-on-failure} &
188 - No & No & No & No & Yes & Yes & Yes \\
189 + No & No & Yes & Yes & Yes \\
190
191 \t{nonfatal} & \compactfeatureref{nonfatal} &
192 - No & No & No & No & Yes & Yes & Yes \\
193 + No & No & Yes & Yes & Yes \\
194
195 \t{dohard} & \compactfeatureref{banned-commands} &
196 - Yes & Yes & Yes & Yes & Banned & Banned & Banned \\
197 + Yes & Yes & Banned & Banned & Banned \\
198
199 \t{dosed} & \compactfeatureref{banned-commands} &
200 - Yes & Yes & Yes & Yes & Banned & Banned & Banned \\
201 + Yes & Yes & Banned & Banned & Banned \\
202
203 Option \t{-{}-host-root} & \compactfeatureref{host-root-option} &
204 - No & No & No & No & No & Yes & Yes \\
205 + No & No & No & Yes & Yes \\
206
207 \t{econf} arguments & \compactfeatureref{econf-options} &
208 - & & & & disable dependency tracking &
209 + & & disable dependency tracking &
210 disable dependency tracking, disable silent rules &
211 disable dependency tracking, disable silent rules \\
212
213 \t{dodoc -r} & \compactfeatureref{dodoc} &
214 - No & No & No & No & Yes & Yes & Yes \\
215 + No & No & Yes & Yes & Yes \\
216
217 \t{doheader} & \compactfeatureref{doheader} &
218 - No & No & No & No & No & Yes & Yes \\
219 + No & No & No & Yes & Yes \\
220
221 \t{doins} handles symlinks & \compactfeatureref{doins} &
222 - No & No & No & No & Yes & Yes & Yes \\
223 + No & No & Yes & Yes & Yes \\
224
225 \t{doman} languages & \compactfeatureref{doman-langs} &
226 - No & No & Yes & Yes & Yes & Yes & Yes \\
227 + * & Yes & Yes & Yes & Yes \\
228
229 \t{doman -i18n} precedence & \compactfeatureref{doman-langs} &
230 - N/A & N/A & No & No & Yes & Yes & Yes \\
231 + * & No & Yes & Yes & Yes \\
232
233 \t{new*} support stdin & \compactfeatureref{newfoo-stdin} &
234 - No & No & No & No & No & Yes & Yes \\
235 + No & No & No & Yes & Yes \\
236
237 Controllable compression & \compactfeatureref{docompress} &
238 - No & No & No & No & Yes & Yes & Yes \\
239 + No & No & Yes & Yes & Yes \\
240
241 \t{docompress} & \compactfeatureref{docompress} &
242 - No & No & No & No & Yes & Yes & Yes \\
243 + No & No & Yes & Yes & Yes \\
244
245 \t{use\_with} empty third arg & \compactfeatureref{use-with} &
246 - No & No & No & No & Yes & Yes & Yes \\
247 + No & No & Yes & Yes & Yes \\
248
249 \t{usex} & \compactfeatureref{usex} &
250 - No & No & No & No & No & Yes & Yes \\
251 + No & No & No & Yes & Yes \\
252
253 \t{unpack} support for \t{xz}? & \compactfeatureref{unpack-extensions} &
254 - No & No & No & Yes & Yes & Yes & Yes \\
255 + No & Yes & Yes & Yes & Yes \\
256
257 \t{default} function & \compactfeatureref{default-func} &
258 - No & No & Yes & Yes & Yes & Yes & Yes \\
259 + * & Yes & Yes & Yes & Yes \\
260
261 File mtimes preserved & \compactfeatureref{mtime-preserve} &
262 - Undefined & Undefined & Undefined & Yes & Yes & Yes & Yes \\
263 + Undefined & Yes & Yes & Yes & Yes \\
264
265 \end{longtable}
266 \end{landscape}
267 --
268 2.6.1