summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2021-05-16 18:44:50 +0200
committerUlrich Müller <ulm@gentoo.org>2021-06-05 10:55:33 +0200
commita14e130eacbd19fb8e835d2d385ac94ba693f23a (patch)
treebad87309eb110d4080011baf05f78e09d867c1cb
parentRelicense from CC-BY-SA-3.0 to CC-BY-SA-4.0 (diff)
downloadpms-a14e130eacbd19fb8e835d2d385ac94ba693f23a.tar.gz
pms-a14e130eacbd19fb8e835d2d385ac94ba693f23a.tar.bz2
pms-a14e130eacbd19fb8e835d2d385ac94ba693f23a.zip
EAPI 8 has less strict naming rules in the updates directory
Bug: https://bugs.gentoo.org/692774 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
-rw-r--r--eapi-differences.tex5
-rw-r--r--tree-layout.tex25
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}