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 |