[gentoo-pms] [PATCH 05/21] EAPI 8 has less strict naming rules in the updates directory

[Ulrich Müller]

Bug: https://bugs.gentoo.org/692774
Signed-off-by: Ulrich Müller <ulm@g.o>
---
 eapi-differences.tex |  5 ++++-
 tree-layout.tex      | 25 +++++++++++++++++++++----
 2 files changed, 25 insertions(+), 5 deletions(-)

diff --git a/eapi-differences.tex b/eapi-differences.tex
index 38109ec..b89ede0 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -44,6 +44,9 @@ of this document for a complete table of previous EAPIs.}
 \t{package.mask} directory & \compactfeatureref{package-mask-dir} &
     No & No & No & Yes & Yes \\
 
+Less strict filenames in \t{updates} & \compactfeatureref{updates-filenames} &
+    No & No & No & No & Yes \\
+
 Profile files as directories & \compactfeatureref{profile-file-dirs} &
     No & No & No & Yes & Yes \\
 
@@ -481,7 +484,7 @@ EAPI 7 is EAPI 6 with the following changes:
 EAPI 8 is EAPI 7 with the following changes:
 
 \begin{compactitem}
-\item None
+\item Less strict naming rules for files in \t{updates} directory, \featureref{updates-filenames}.
 \end{compactitem}
 
 \ChangeWhenAddingAnEAPI{8}
diff --git a/tree-layout.tex b/tree-layout.tex
index 81599a9..aa04d3d 100644
--- a/tree-layout.tex
+++ b/tree-layout.tex
@@ -207,11 +207,14 @@ differs from that described in \t{use.desc}.
 
 \subsection{The updates directory}
 \label{sec:updates-dir}
-The \t{updates} directory is used to inform the package manager that a package has moved categories,
-names, or that a version has changed SLOT\@. It contains one file per quarter year, named
+\featurelabel{updates-filenames} The \t{updates} directory is used to inform the package manager
+that a package has moved categories, names, or that a version has changed SLOT\@. For EAPIs
+so specified by table~\ref{tab:updates-filenames}, it contains one file per quarter year, named
 \t{[1-4]Q-[YYYY]} for the first to fourth quarter of a given year, for example \t{1Q-2004} or
-\t{3Q-2006}. The format of each file is again line-based, with each line having one of the following
-formats:
+\t{3Q-2006}. For other EAPIs, all regular files in this directory will be processed, unless their
+name begins with a dot.
+
+The format of each file is again line-based, with each line having one of the following formats:
 \begin{verbatim}
 move <qpn1> <qpn2>
 slotmove <spec> <slot1> <slot2>
@@ -230,6 +233,20 @@ Any name that has appeared as the origin of a move must not be reused in the fut
 that has appeared as the origin of a slot move may not be used by packages matching the spec of
 that slot move in the future.
 
+\ChangeWhenAddingAnEAPI{8}
+\begin{centertable}{Naming rules for files in \t{updates} directory for EAPIs}
+    \label{tab:updates-filenames}
+    \begin{tabular}{ll}
+      \toprule
+      \multicolumn{1}{c}{\textbf{EAPI}} &
+      \multicolumn{1}{c}{\textbf{Files per quarter year?}} \\
+      \midrule
+      0, 1, 2, 3, 4, 5, 6, 7  & Yes \\
+      8                       & No  \\
+      \bottomrule
+    \end{tabular}
+\end{centertable}
+
 \section{The Licenses Directory}
 \label{sec:licenses-dir}
 
-- 
2.31.1