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 3/5] EAPI 9 profile parent files can contain comments
Date: Mon, 21 Feb 2022 19:01:38
Message-Id: 20220221190050.11524-3-ulm@gentoo.org
In Reply to: [gentoo-pms] [PATCH 1/5] Add an EAPI 9 identical to EAPI 8 by "Ulrich Müller"
1 Bug: https://bugs.gentoo.org/470094
2 Signed-off-by: Ulrich Müller <ulm@g.o>
3 ---
4 eapi-differences.tex | 5 ++++-
5 profiles.tex | 20 +++++++++++++++++++-
6 2 files changed, 23 insertions(+), 2 deletions(-)
7
8 diff --git a/eapi-differences.tex b/eapi-differences.tex
9 index 893caf3..bb84b85 100644
10 --- a/eapi-differences.tex
11 +++ b/eapi-differences.tex
12 @@ -47,6 +47,9 @@ of this document for a complete table of previous EAPIs.}
13 Less strict filenames in \t{updates} & \compactfeatureref{updates-filenames} &
14 No & No & No & Yes & Yes \\
15
16 +Comments in profiles \t{parent} file & \compactfeatureref{parent-comments} &
17 + No & No & No & No & Yes \\
18 +
19 Profile files as directories & \compactfeatureref{profile-file-dirs} &
20 No & No & Yes & Yes & Yes \\
21
22 @@ -551,7 +554,7 @@ EAPI 8 is EAPI 7 with the following changes:
23 EAPI 9 is EAPI 8 with the following changes:
24
25 \begin{compactitem}
26 -\item None
27 +\item Comments in profiles \t{parent} file, \featureref{parent-comments}.
28 \end{compactitem}
29
30 \ChangeWhenAddingAnEAPI{9}
31 diff --git a/profiles.tex b/profiles.tex
32 index 8d8226a..6fa8a1c 100644
33 --- a/profiles.tex
34 +++ b/profiles.tex
35 @@ -25,7 +25,25 @@ first, left to right, with duplicate parent paths being sourced for every time t
36 It is illegal for a profile's parent tree to contain cycles. Package manager behaviour upon
37 encountering a cycle is undefined.
38
39 -This file must not contain comments, blank lines or make use of line continuations.
40 +This file must not make use of line continuations.
41 +
42 +\featurelabel{parent-comments} For EAPIs listed in table~\ref{tab:profile-parent-comments} as
43 +allowing comments, blank lines and lines beginning with a \t{\#} are discarded. For other EAPIs,
44 +this file must not contain comments or blank lines.
45 +
46 +\ChangeWhenAddingAnEAPI{9}
47 +\begin{centertable}{EAPIs allowing comments in \t{parent} file}
48 + \label{tab:profile-parent-comments}
49 + \begin{tabular}{ll}
50 + \toprule
51 + \multicolumn{1}{c}{\textbf{EAPI}} &
52 + \multicolumn{1}{c}{\textbf{Allows comments?}} \\
53 + \midrule
54 + 0, 1, 2, 3, 4, 5, 6, 7, 8 & No \\
55 + 9 & Yes \\
56 + \bottomrule
57 + \end{tabular}
58 +\end{centertable}
59
60 \subsection{The eapi file}
61 \label{sec:profile-eapi}
62 --
63 2.35.1