From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <gentoo-commits+bounces-1429665-garchives=archives.gentoo.org@lists.gentoo.org>
Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (2048 bits))
(No client certificate requested)
by finch.gentoo.org (Postfix) with ESMTPS id AC1F7158094
for <garchives@archives.gentoo.org>; Mon, 22 Aug 2022 18:30:24 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
by pigeon.gentoo.org (Postfix) with SMTP id EFFF3E086E;
Mon, 22 Aug 2022 18:30:22 +0000 (UTC)
Received: from smtp.gentoo.org (woodpecker.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256)
(No client certificate requested)
by pigeon.gentoo.org (Postfix) with ESMTPS id 8C1AFE086E
for <gentoo-commits@lists.gentoo.org>; Mon, 22 Aug 2022 18:30:22 +0000 (UTC)
Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256)
(No client certificate requested)
by smtp.gentoo.org (Postfix) with ESMTPS id 7C89C340ED2
for <gentoo-commits@lists.gentoo.org>; Mon, 22 Aug 2022 18:30:21 +0000 (UTC)
Received: from localhost.localdomain (localhost [IPv6:::1])
by oystercatcher.gentoo.org (Postfix) with ESMTP id A27AD56D
for <gentoo-commits@lists.gentoo.org>; Mon, 22 Aug 2022 18:30:19 +0000 (UTC)
From: "Ulrich Müller" <ulm@gentoo.org>
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 Müller" <ulm@gentoo.org>
Message-ID: <1661192996.591f04599193765ae803fa0d681a7d7013e703bf.ulm@gentoo>
Subject: [gentoo-commits] proj/pms:eapi-9 commit in: /
X-VCS-Repository: proj/pms
X-VCS-Files: eapi-differences.tex pms.cls
X-VCS-Directories: /
X-VCS-Committer: ulm
X-VCS-Committer-Name: Ulrich Müller
X-VCS-Revision: 591f04599193765ae803fa0d681a7d7013e703bf
X-VCS-Branch: eapi-9
Date: Mon, 22 Aug 2022 18:30:19 +0000 (UTC)
Precedence: bulk
List-Post: <mailto:gentoo-commits@lists.gentoo.org>
List-Help: <mailto:gentoo-commits+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org>
X-BeenThere: gentoo-commits@lists.gentoo.org
X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply
X-Archives-Salt: 47fc1025-676e-4026-a7f4-2c598bdc2086
X-Archives-Hash: 5a28c5a9f04e2409aefaec3dd0e960cc
commit: 591f04599193765ae803fa0d681a7d7013e703bf
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 Aug 22 18:29:56 2022 +0000
URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=591f0459
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 a5ba486..c727758 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}
}