commit: 97b6b7ccd4f15c706a8978a6f2e23056eeb3a305 Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> AuthorDate: Sun May 16 16:44:50 2021 +0000 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> CommitDate: Mon May 17 04:54:27 2021 +0000 URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=97b6b7cc
EAPI 8 has less strict naming rules in the updates directory Bug: https://bugs.gentoo.org/692774 Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> eapi-differences.tex | 4 ++++ tree-layout.tex | 25 +++++++++++++++++++++---- 2 files changed, 25 insertions(+), 4 deletions(-) diff --git a/eapi-differences.tex b/eapi-differences.tex index 9b7b709..b0d3707 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 \\ @@ -520,6 +523,7 @@ EAPI 8 is EAPI 7 with the following changes: \item Bash version is 5.0, \featureref{bash-version}. \item \t{insopts} no longer affects \t{doconfd}, \t{doenvd} and \t{doheader}, \featureref{insopts}. \item \t{exeopts} no longer affects \t{doinitd}, \featureref{exeopts}. +\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 ab8a02a..b42bd3f 100644 --- a/tree-layout.tex +++ b/tree-layout.tex @@ -205,11 +205,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> @@ -225,6 +228,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}