1 |
commit: b1ff4da59d21de1f388eb22cf79593e7bde70cb1 |
2 |
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
3 |
AuthorDate: Sun May 16 16:44:50 2021 +0000 |
4 |
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
5 |
CommitDate: Mon May 17 21:21:00 2021 +0000 |
6 |
URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=b1ff4da5 |
7 |
|
8 |
EAPI 8 has less strict naming rules in the updates directory |
9 |
|
10 |
Bug: https://bugs.gentoo.org/692774 |
11 |
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> |
12 |
|
13 |
eapi-differences.tex | 5 ++++- |
14 |
tree-layout.tex | 25 +++++++++++++++++++++---- |
15 |
2 files changed, 25 insertions(+), 5 deletions(-) |
16 |
|
17 |
diff --git a/eapi-differences.tex b/eapi-differences.tex |
18 |
index 38109ec..b89ede0 100644 |
19 |
--- a/eapi-differences.tex |
20 |
+++ b/eapi-differences.tex |
21 |
@@ -44,6 +44,9 @@ of this document for a complete table of previous EAPIs.} |
22 |
\t{package.mask} directory & \compactfeatureref{package-mask-dir} & |
23 |
No & No & No & Yes & Yes \\ |
24 |
|
25 |
+Less strict filenames in \t{updates} & \compactfeatureref{updates-filenames} & |
26 |
+ No & No & No & No & Yes \\ |
27 |
+ |
28 |
Profile files as directories & \compactfeatureref{profile-file-dirs} & |
29 |
No & No & No & Yes & Yes \\ |
30 |
|
31 |
@@ -481,7 +484,7 @@ EAPI 7 is EAPI 6 with the following changes: |
32 |
EAPI 8 is EAPI 7 with the following changes: |
33 |
|
34 |
\begin{compactitem} |
35 |
-\item None |
36 |
+\item Less strict naming rules for files in \t{updates} directory, \featureref{updates-filenames}. |
37 |
\end{compactitem} |
38 |
|
39 |
\ChangeWhenAddingAnEAPI{8} |
40 |
|
41 |
diff --git a/tree-layout.tex b/tree-layout.tex |
42 |
index ab8a02a..b42bd3f 100644 |
43 |
--- a/tree-layout.tex |
44 |
+++ b/tree-layout.tex |
45 |
@@ -205,11 +205,14 @@ differs from that described in \t{use.desc}. |
46 |
|
47 |
\subsection{The updates directory} |
48 |
\label{sec:updates-dir} |
49 |
-The \t{updates} directory is used to inform the package manager that a package has moved categories, |
50 |
-names, or that a version has changed SLOT\@. It contains one file per quarter year, named |
51 |
+\featurelabel{updates-filenames} The \t{updates} directory is used to inform the package manager |
52 |
+that a package has moved categories, names, or that a version has changed SLOT\@. For EAPIs |
53 |
+so specified by table~\ref{tab:updates-filenames}, it contains one file per quarter year, named |
54 |
\t{[1-4]Q-[YYYY]} for the first to fourth quarter of a given year, for example \t{1Q-2004} or |
55 |
-\t{3Q-2006}. The format of each file is again line-based, with each line having one of the following |
56 |
-formats: |
57 |
+\t{3Q-2006}. For other EAPIs, all regular files in this directory will be processed, unless their |
58 |
+name begins with a dot. |
59 |
+ |
60 |
+The format of each file is again line-based, with each line having one of the following formats: |
61 |
\begin{verbatim} |
62 |
move <qpn1> <qpn2> |
63 |
slotmove <spec> <slot1> <slot2> |
64 |
@@ -225,6 +228,20 @@ Any name that has appeared as the origin of a move must not be reused in the fut |
65 |
that has appeared as the origin of a slot move may not be used by packages matching the spec of |
66 |
that slot move in the future. |
67 |
|
68 |
+\ChangeWhenAddingAnEAPI{8} |
69 |
+\begin{centertable}{Naming rules for files in \t{updates} directory for EAPIs} |
70 |
+ \label{tab:updates-filenames} |
71 |
+ \begin{tabular}{ll} |
72 |
+ \toprule |
73 |
+ \multicolumn{1}{c}{\textbf{EAPI}} & |
74 |
+ \multicolumn{1}{c}{\textbf{Files per quarter year?}} \\ |
75 |
+ \midrule |
76 |
+ 0, 1, 2, 3, 4, 5, 6, 7 & Yes \\ |
77 |
+ 8 & No \\ |
78 |
+ \bottomrule |
79 |
+ \end{tabular} |
80 |
+\end{centertable} |
81 |
+ |
82 |
\section{The Licenses Directory} |
83 |
\label{sec:licenses-dir} |