summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2022-02-21 19:30:11 +0100
committerUlrich Müller <ulm@gentoo.org>2022-08-22 20:29:57 +0200
commit78f161bf267da8b25d58b927cc334212f3c0a054 (patch)
tree9f5124bdb6d1d3683d2515f3a0b6e704a027bd94
parentAdd an EAPI 9 identical to EAPI 8 (diff)
downloadpms-78f161bf.tar.gz
pms-78f161bf.tar.bz2
pms-78f161bf.zip
EAPI 9 profile parent files can contain comments
Bug: https://bugs.gentoo.org/470094 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
-rw-r--r--eapi-differences.tex5
-rw-r--r--profiles.tex20
2 files changed, 23 insertions, 2 deletions
diff --git a/eapi-differences.tex b/eapi-differences.tex
index e48ea54..682b336 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -32,6 +32,9 @@ have identical entries for all listed EAPIs.}
Less strict filenames in \t{updates} & \compactfeatureref{updates-filenames} &
No & No & Yes & Yes \\
+Comments in profiles \t{parent} file & \compactfeatureref{parent-comments} &
+ No & No & No & Yes \\
+
Profile files as directories & \compactfeatureref{profile-file-dirs} &
No & Yes & Yes & Yes \\
@@ -352,7 +355,7 @@ EAPI 8 is EAPI 7 with the following changes:
EAPI 9 is EAPI 8 with the following changes:
\begin{compactitem}
-\item None
+\item Comments in profiles \t{parent} file, \featureref{parent-comments}.
\end{compactitem}
\ChangeWhenAddingAnEAPI{9}
diff --git a/profiles.tex b/profiles.tex
index 8d8226a..6fa8a1c 100644
--- a/profiles.tex
+++ b/profiles.tex
@@ -25,7 +25,25 @@ first, left to right, with duplicate parent paths being sourced for every time t
It is illegal for a profile's parent tree to contain cycles. Package manager behaviour upon
encountering a cycle is undefined.
-This file must not contain comments, blank lines or make use of line continuations.
+This file must not make use of line continuations.
+
+\featurelabel{parent-comments} For EAPIs listed in table~\ref{tab:profile-parent-comments} as
+allowing comments, blank lines and lines beginning with a \t{\#} are discarded. For other EAPIs,
+this file must not contain comments or blank lines.
+
+\ChangeWhenAddingAnEAPI{9}
+\begin{centertable}{EAPIs allowing comments in \t{parent} file}
+ \label{tab:profile-parent-comments}
+ \begin{tabular}{ll}
+ \toprule
+ \multicolumn{1}{c}{\textbf{EAPI}} &
+ \multicolumn{1}{c}{\textbf{Allows comments?}} \\
+ \midrule
+ 0, 1, 2, 3, 4, 5, 6, 7, 8 & No \\
+ 9 & Yes \\
+ \bottomrule
+ \end{tabular}
+\end{centertable}
\subsection{The eapi file}
\label{sec:profile-eapi}