commit: d7ad6126cfc378797557e94e48386929694f133e
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Fri Aug 19 21:22:40 2022 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Mon Apr 10 07:17:09 2023 +0000
URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=d7ad6126
EAPI feature table: Don't use a landscape table
Drop EAPIs 0 to 5 from the table, as well as items that would have
identical entries for all listed EAPIs.
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
eapi-differences.tex | 321 ++++++++++-----------------------------------------
pms.cls | 2 +-
2 files changed, 61 insertions(+), 262 deletions(-)
diff --git a/eapi-differences.tex b/eapi-differences.tex
index 225c2b6..b20693a 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -1,39 +1,24 @@
\chapter{Feature Availability by EAPI}
\note{This chapter is informative and for convenience only. Refer to the main
text for specifics.
-For lack of space, EAPIs 0, 1, 2, 3, and~4 have been consolidated into a
single column in the table
-below; entries marked with an asterisk differ between these EAPIs. See the
2012-09-20 edition
-of this document for a complete table of previous EAPIs.}
-% 2012-09-20 (EAPI 5) edition has a table of EAPIs 0 to 5
+For lack of space, EAPIs 0 to~5 have been omitted from the table below, as
well as items that would
+have identical entries for all listed EAPIs.}
\ChangeWhenAddingAnEAPI{8}
-\begin{landscape}
-\begin{longtable}{llP{7.5em}P{7.5em}P{7.5em}P{7.5em}P{7.5em}}
+\begin{longtable}{@{}lllll@{}}
\caption{Features in EAPIs}\\
\toprule
\multicolumn{1}{c}{\textbf{Feature}} &
-\multicolumn{1}{c}{\textbf{Reference}} &
-\multicolumn{5}{c}{\textbf{EAPIs}} \\
-\multicolumn{1}{c}{} &
-\multicolumn{1}{c}{} &
-\multicolumn{1}{c}{0, 1, 2, 3, 4} &
-\multicolumn{1}{c}{5} &
-\multicolumn{1}{c}{6} &
-\multicolumn{1}{c}{7} &
-\multicolumn{1}{c}{8} \\
+\multicolumn{1}{c}{\textbf{Ref.}} &
+\multicolumn{3}{c}{\textbf{EAPIs}} \\
+& & 6 & 7 & 8 \\
\midrule
\endfirsthead
\midrule
\multicolumn{1}{c}{\textbf{Feature}} &
-\multicolumn{1}{c}{\textbf{Reference}} &
-\multicolumn{5}{c}{\textbf{EAPIs}} \\
-\multicolumn{1}{c}{} &
-\multicolumn{1}{c}{} &
-\multicolumn{1}{c}{0, 1, 2, 3, 4} &
-\multicolumn{1}{c}{5} &
-\multicolumn{1}{c}{6} &
-\multicolumn{1}{c}{7} &
-\multicolumn{1}{c}{8} \\
+\multicolumn{1}{c}{\textbf{Ref.}} &
+\multicolumn{3}{c}{\textbf{EAPIs}} \\
+& & 6 & 7 & 8 \\
\midrule
\endhead
\midrule
@@ -42,334 +27,148 @@ of this document for a complete table of previous EAPIs.}
\endlastfoot
\t{package.mask} directory & \compactfeatureref{package-mask-dir} &
- No & No & No & Yes & Yes \\
+ No & Yes & Yes \\
Less strict filenames in \t{updates} & \compactfeatureref{updates-filenames} &
- No & No & No & No & Yes \\
+ No & No & Yes \\
Profile files as directories & \compactfeatureref{profile-file-dirs} &
- No & No & No & Yes & Yes \\
+ No & Yes & Yes \\
\t{package.provided} & \compactfeatureref{package-provided} &
- Optional & Optional & Optional & No & No \\
-
-Stable use masking/forcing & \compactfeatureref{stablemask} &
- No & Yes & Yes & Yes & Yes \\
+ Optional & No & No \\
Bash version & \compactfeatureref{bash-version} &
- 3.2 & 3.2 & 4.2 & 4.2 & 5.0 \\
-
-\t{failglob} in global scope & \compactfeatureref{failglob} &
- No & No & Yes & Yes & Yes \\
-
-\t{IUSE} defaults & \compactfeatureref{iuse-defaults} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{REQUIRED_USE} & \compactfeatureref{required-use} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{PROPERTIES} & \compactfeatureref{properties} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{SRC_URI} arrows & \compactfeatureref{src-uri-arrows} &
- * & Yes & Yes & Yes & Yes \\
+ 4.2 & 4.2 & 5.0 \\
Selective URI restrictions & \compactfeatureref{uri-restrict} &
- No & No & No & No & Yes \\
-
-\t{RDEPEND=DEPEND} & \compactfeatureref{rdepend-depend} &
- * & No & No & No & No \\
-
-\t{DEFINED_PHASES} & \compactfeatureref{defined-phases} &
- * & Yes & Yes & Yes & Yes \\
+ No & No & Yes \\
\t{BDEPEND} & \compactfeatureref{bdepend} &
- No & No & No & Yes & Yes \\
+ No & Yes & Yes \\
\t{IDEPEND} & \compactfeatureref{idepend} &
- No & No & No & No & Yes \\
-
-\t{??\ ( )} groups & \compactfeatureref{at-most-one-of} &
- No & Yes & Yes & Yes & Yes \\
+ No & No & Yes \\
Empty \t{||}, \t{\textasciicircum\textasciicircum} groups match &
\compactfeatureref{empty-dep-groups} &
- Yes & Yes & Yes & No & No \\
-
-Slot dependencies & \compactfeatureref{slot-deps} &
- * & Named and Operator & Named and Operator & Named and Operator & Named
and Operator \\
-
-Sub-slots & \compactfeatureref{sub-slot} &
- No & Yes & Yes & Yes & Yes \\
-
-Use dependencies & \compactfeatureref{use-deps} &
- * & 4-style & 4-style & 4-style & 4-style \\
-
-\t{!}\ blockers & \compactfeatureref{bang-strength} &
- * & Weak & Weak & Weak & Weak \\
-
-\t{!!}\ blockers & \compactfeatureref{bang-strength} &
- * & Strong & Strong & Strong & Strong \\
+ Yes & No & No \\
Working dir in \t{pkg_*} phases & \compactfeatureref{phase-function-dir} &
- Any & Any & Any & Any & Empty \\
-
-\t{S} to \t{WORKDIR} fallback & \compactfeatureref{s-workdir-fallback} &
- * & Conditional & Conditional & Conditional & Conditional \\
-
-\t{pkg_pretend} & \compactfeatureref{pkg-pretend} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{src_prepare} & \compactfeatureref{src-prepare} &
- * & Yes & Yes & Yes & Yes \\
+ Any & Any & Empty \\
\t{src_prepare} style & \compactfeatureref{src-prepare} &
- * & no-op & 6 & 6 & 8 \\
-
-\t{src_configure} & \compactfeatureref{src-configure} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{src_compile} style & \compactfeatureref{src-compile} &
- * & 2 & 2 & 2 & 2 \\
-
-Parallel tests & \compactfeatureref{parallel-tests} &
- No & Yes & Yes & Yes & Yes \\
-
-\t{src_install} style & \compactfeatureref{src-install} &
- * & 4 & 6 & 6 & 6 \\
-
-\t{pkg_info} & \compactfeatureref{pkg-info} &
- * & Both & Both & Both & Both \\
-
-\t{default_} phase functions & \compactfeatureref{default-phase-funcs} &
- * &
- \t{pkg_nofetch}, \t{src_unpack}, \t{src_prepare}, \t{src_configure},
- \t{src_compile}, \t{src_test}, \t{src_install} &
- \t{pkg_nofetch}, \t{src_unpack}, \t{src_prepare}, \t{src_configure},
- \t{src_compile}, \t{src_test}, \t{src_install} &
- \t{pkg_nofetch}, \t{src_unpack}, \t{src_prepare}, \t{src_configure},
- \t{src_compile}, \t{src_test}, \t{src_install} &
- \t{pkg_nofetch}, \t{src_unpack}, \t{src_prepare}, \t{src_configure},
- \t{src_compile}, \t{src_test}, \t{src_install} \\
+ 6 & 6 & 8 \\
Accumulate \t{PROPERTIES} & \compactfeatureref{accumulate-vars} &
- No & No & No & No & Yes \\
+ No & No & Yes \\
Accumulate \t{RESTRICT} & \compactfeatureref{accumulate-vars} &
- No & No & No & No & Yes \\
-
-\t{AA} & \compactfeatureref{aa} &
- * & No & No & No & No \\
+ No & No & Yes \\
\t{PORTDIR} & \compactfeatureref{portdir} &
- Yes & Yes & Yes & No & No \\
+ Yes & No & No \\
\t{ECLASSDIR} & \compactfeatureref{eclassdir} &
- Yes & Yes & Yes & No & No \\
+ Yes & No & No \\
\t{SYSROOT}, \t{ESYSROOT} & \compactfeatureref{sysroot} &
- No & No & No & Yes & Yes \\
+ No & Yes & Yes \\
\t{BROOT} & \compactfeatureref{broot} &
- No & No & No & Yes & Yes \\
+ No & Yes & Yes \\
\t{DESTTREE} & \compactfeatureref{desttree} &
- Yes & Yes & Yes & No & No \\
+ Yes & No & No \\
\t{INSDESTTREE} & \compactfeatureref{insdesttree} &
- Yes & Yes & Yes & No & No \\
-
-\t{KV} & \compactfeatureref{kv} &
- * & No & No & No & No \\
-
-\t{EBUILD_PHASE_FUNC} & \compactfeatureref{ebuild-phase-func} &
- No & Yes & Yes & Yes & Yes \\
-
-\t{MERGE_TYPE} & \compactfeatureref{merge-type} &
- * & Yes & Yes & Yes & Yes \\
+ Yes & No & No \\
\t{ENV_UNSET} & \compactfeatureref{env-unset} &
- No & No & No & Yes & Yes \\
-
-Sane locale settings & \compactfeatureref{locale-settings} &
- Undefined & Undefined & Yes & Yes & Yes \\
-
-Profile \t{IUSE} injection & \compactfeatureref{profile-iuse-inject} &
- No & Yes & Yes & Yes & Yes \\
-
-\t{REPLACING_VERSIONS} & \compactfeatureref{replace-version-vars} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{REPLACED_BY_VERSION} & \compactfeatureref{replace-version-vars} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{EPREFIX}, \t{ED}, \t{EROOT} & \compactfeatureref{offset-prefix-vars} &
- * & Yes & Yes & Yes & Yes \\
+ No & Yes & Yes \\
Trailing slash in \t{D} etc. & \compactfeatureref{trailing-slash} &
- Yes & Yes & Yes & No & No \\
+ Yes & No & No \\
GNU \t{patch} version & \compactfeatureref{gnu-patch} &
- Any & Any & Any & 2.7 & 2.7 \\
-
-\t{find} is GNU? & \compactfeatureref{gnu-find} &
- Undefined & Yes & Yes & Yes & Yes \\
-
-Most utilities die & \compactfeatureref{die-on-failure} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{nonfatal} & \compactfeatureref{nonfatal} &
- * & Yes & Yes & Function / external & Function / external \\
-
-\t{dohard} & \compactfeatureref{banned-commands} &
- * & Banned & Banned & Banned & Banned \\
+ Any & 2.7 & 2.7 \\
-\t{dosed} & \compactfeatureref{banned-commands} &
- * & Banned & Banned & Banned & Banned \\
-
-\t{einstall} & \compactfeatureref{banned-commands} &
- Yes & Yes & Banned & Banned & Banned \\
+\t{nonfatal} function and external & \compactfeatureref{nonfatal} &
+ No & Yes & Yes \\
\t{dohtml} & \compactfeatureref{banned-commands} &
- Yes & Yes & Yes & Banned & Banned \\
+ Yes & Banned & Banned \\
\t{dolib} & \compactfeatureref{banned-commands} &
- Yes & Yes & Yes & Banned & Banned \\
+ Yes & Banned & Banned \\
\t{libopts} & \compactfeatureref{banned-commands} &
- Yes & Yes & Yes & Banned & Banned \\
+ Yes & Banned & Banned \\
\t{useq} & \compactfeatureref{banned-commands} &
- Yes & Yes & Yes & Yes & Banned \\
+ Yes & Yes & Banned \\
\t{hasv} & \compactfeatureref{banned-commands} &
- Yes & Yes & Yes & Yes & Banned \\
+ Yes & Yes & Banned \\
\t{hasq} & \compactfeatureref{banned-commands} &
- Yes & Yes & Yes & Yes & Banned \\
+ Yes & Yes & Banned \\
Query command options & \compactfeatureref{pm-query-options} &
- None & \t{-{}-host-root} & \t{-{}-host-root} & \t{-b}, \t{-d}, \t{-r} &
- \t{-b}, \t{-d}, \t{-r} \\
+ \t{-{}-host-root} & \t{-b}, \t{-d}, \t{-r} & \t{-b}, \t{-d}, \t{-r} \\
Output commands use stdout & \compactfeatureref{output-no-stdout} &
- Yes & Yes & Yes & No & No \\
+ Yes & No & No \\
\t{eqawarn} & \compactfeatureref{eqawarn} &
- No & No & No & Yes & Yes \\
-
-\t{die -n} & \compactfeatureref{nonfatal-die} &
- No & No & Yes & Yes & Yes \\
+ No & Yes & Yes \\
\t{die} in subshell & \compactfeatureref{subshell-die} &
- No & No & No & Yes & Yes \\
-
-\t{eapply} & \compactfeatureref{eapply} &
- No & No & Yes & Yes & Yes \\
-
-\t{eapply_user} & \compactfeatureref{eapply-user} &
- No & No & Yes & Yes & Yes \\
-
-\t{econf} arguments & \compactfeatureref{econf-options} &
- * &
- disable dependency tracking, disable silent rules &
- disable dependency tracking, disable silent rules, docdir, htmldir &
- disable dependency tracking, disable silent rules, docdir, htmldir, with
sysroot &
- disable dependency tracking, disable silent rules, disable static,
- datarootdir, docdir, htmldir, with sysroot \\
-
-\t{dodoc -r} & \compactfeatureref{dodoc} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{doheader} & \compactfeatureref{doheader} &
- No & Yes & Yes & Yes & Yes \\
+ No & Yes & Yes \\
-\t{doins} handles symlinks & \compactfeatureref{doins} &
- * & Yes & Yes & Yes & Yes \\
+\t{econf -{}-datarootdir} & \compactfeatureref{econf-options} &
+ No & No & Yes \\
-\t{doman} languages & \compactfeatureref{doman-langs} &
- * & Yes & Yes & Yes & Yes \\
+\t{econf -{}-with-sysroot} & \compactfeatureref{econf-options} &
+ No & Yes & Yes \\
-\t{doman -i18n} precedence & \compactfeatureref{doman-langs} &
- * & Yes & Yes & Yes & Yes \\
+\t{econf -{}-disable-static} & \compactfeatureref{econf-options} &
+ No & No & Yes \\
\t{domo} destination path & \compactfeatureref{domo-path} &
- \t{\$\{DESTTREE\}} & \t{\$\{DESTTREE\}} & \t{\$\{DESTTREE\}} & \t{/usr} &
\t{/usr} \\
+ \t{\$\{DESTTREE\}} & \t{/usr} & \t{/usr} \\
\t{dosym -r} & \compactfeatureref{dosym-relative} &
- No & No & No & No & Yes \\
-
-\t{new*} support stdin & \compactfeatureref{newfoo-stdin} &
- No & Yes & Yes & Yes & Yes \\
+ No & No & Yes \\
\t{insopts} affects misc.\ commands & \compactfeatureref{insopts} &
- Yes & Yes & Yes & Yes & No \\
+ Yes & Yes & No \\
\t{exeopts} affects \t{doinitd} & \compactfeatureref{exeopts} &
- Yes & Yes & Yes & Yes & No \\
-
-Controllable compression & \compactfeatureref{docompress} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{docompress} & \compactfeatureref{docompress} &
- * & Yes & Yes & Yes & Yes \\
+ Yes & Yes & No \\
Controllable stripping & \compactfeatureref{dostrip} &
- No & No & No & Yes & Yes \\
+ No & Yes & Yes \\
\t{dostrip} & \compactfeatureref{dostrip} &
- No & No & No & Yes & Yes \\
+ No & Yes & Yes \\
\t{usev} second arg & \compactfeatureref{usev} &
- No & No & No & No & Yes \\
-
-\t{use_with} empty third arg & \compactfeatureref{use-with} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{usex} & \compactfeatureref{usex} &
- No & Yes & Yes & Yes & Yes \\
-
-\t{in_iuse} & \compactfeatureref{in-iuse} &
- No & No & Yes & Yes & Yes \\
+ No & No & Yes \\
\t{ver_*} commands & \compactfeatureref{ver-commands} &
- No & No & No & Yes & Yes \\
-
-\t{unpack} absolute paths & \compactfeatureref{unpack-absolute} &
- No & No & Yes & Yes & Yes \\
-
-\t{unpack} support for \t{xz} & \compactfeatureref{unpack-extensions} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{unpack} support for \t{txz} & \compactfeatureref{unpack-extensions} &
- No & No & Yes & Yes & Yes \\
+ No & Yes & Yes \\
\t{unpack} support for \t{7z} & \compactfeatureref{unpack-extensions} &
- Yes & Yes & Yes & Yes & No \\
+ Yes & Yes & No \\
\t{unpack} support for \t{lha} & \compactfeatureref{unpack-extensions} &
- Yes & Yes & Yes & Yes & No \\
+ Yes & Yes & No \\
\t{unpack} support for \t{rar} & \compactfeatureref{unpack-extensions} &
- Yes & Yes & Yes & Yes & No \\
-
-\t{unpack} case-insensitive & \compactfeatureref{unpack-ignore-case} &
- No & No & Yes & Yes & Yes \\
-
-\t{default} function & \compactfeatureref{default-func} &
- * & Yes & Yes & Yes & Yes \\
-
-\t{einstalldocs} & \compactfeatureref{einstalldocs} &
- No & No & Yes & Yes & Yes \\
-
-\t{get_libdir} & \compactfeatureref{get-libdir} &
- No & No & Yes & Yes & Yes \\
-
-File mtimes preserved & \compactfeatureref{mtime-preserve} &
- * & Yes & Yes & Yes & Yes \\
+ Yes & Yes & No \\
\end{longtable}
-\end{landscape}
\chapter{Differences Between EAPIs}
diff --git a/pms.cls b/pms.cls
index b29a9c3..d4b416f 100644
--- a/pms.cls
+++ b/pms.cls
@@ -82,7 +82,7 @@
\framebox{\textsc{#1}}}
}{%
\newcommand{\featureref}[1]{\textsc{#1} on page~\pageref{feat:#1}}
- \newcommand{\compactfeatureref}[1]{#1~p\pageref{feat:#1}}
+ \newcommand{\compactfeatureref}[1]{p.\,\pageref{feat:#1}}
\newcommand{\featurelabel}[1]{\leavevmode\label{feat:#1}%
\marginnote{\framebox{\textsc{#1}}}\ignorespaces}
}
