From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id E2448138CB8 for ; Tue, 3 Mar 2015 07:37:14 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 2AC1BE08A8; Tue, 3 Mar 2015 07:37:14 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 81147E0894 for ; Tue, 3 Mar 2015 07:37:13 +0000 (UTC) Received: from manakin.gentoo.org (static-108-28-123-98.washdc.fios.verizon.net [108.28.123.98]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 63C9234095E for ; Tue, 3 Mar 2015 07:37:12 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by manakin.gentoo.org (Postfix) with ESMTP id 08EEE60762 for ; Tue, 3 Mar 2015 06:18:42 +0000 (UTC) From: "git@oystercatcher mirror+tproxy" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "git@oystercatcher mirror+tproxy" Message-ID: <1424333849.c951cac4e7b045f04c75070e147ac713f5e95885.git@gentoo> Subject: [gentoo-commits] proj/pms:eapi-6 commit in: / X-VCS-Repository: proj/pms X-VCS-Files: eapi-differences.tex profiles.tex X-VCS-Directories: / X-VCS-Committer: git X-VCS-Committer-Name: git@oystercatcher mirror+tproxy X-VCS-Revision: c951cac4e7b045f04c75070e147ac713f5e95885 X-VCS-Branch: eapi-6 Date: Tue, 3 Mar 2015 06:18:42 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 20bb7cde-ba5f-4e1d-9be6-35d3ced72fb1 X-Archives-Hash: 6c66048d454b7e692812cb2bf52720ae commit: c951cac4e7b045f04c75070e147ac713f5e95885 Author: Michael Palimaka gentoo org> AuthorDate: Sun May 11 19:15:06 2014 +0000 Commit: git@oystercatcher mirror+tproxy oystercatcher gentoo org> CommitDate: Thu Feb 19 08:17:29 2015 +0000 URL: http://sources.gentoo.org/gitweb/?p=proj/pms.git;a=commit;h=c951cac4 EAPI 6 supports package.* and use.* directories. See bug 282296. --- eapi-differences.tex | 5 ++++- profiles.tex | 32 ++++++++++++++++++++++++++------ 2 files changed, 30 insertions(+), 7 deletions(-) diff --git a/eapi-differences.tex b/eapi-differences.tex index 6a7aa00..b3a757a 100644 --- a/eapi-differences.tex +++ b/eapi-differences.tex @@ -41,6 +41,9 @@ of this document for a complete table of previous EAPIs. \bottomrule \endlastfoot +\t{package*} and \t{use*} dirs & \compactfeatureref{profile-file-dirs} & + No & No & No & No & Yes \\ + Stable use masking/forcing & \compactfeatureref{stablemask} & No & No & No & Yes & Yes \\ @@ -304,7 +307,7 @@ EAPI 5 is EAPI 4 with the following changes: EAPI 6 is EAPI 5 with the following changes: \begin{compactitem} -\item None +\item Profile \t{package*} and \t{use*} can be directories, \featureref{profile-file-dirs}. \end{compactitem} \ChangeWhenAddingAnEAPI{6} diff --git a/profiles.tex b/profiles.tex index f71b537..55c7acf 100644 --- a/profiles.tex +++ b/profiles.tex @@ -70,19 +70,39 @@ parent profile's list is taken, and the current profile's list appended. If any hyphen, then any lines previous to it whose contents are equal to the remainder of that line are removed from the list. Once again, blank lines and those beginning with a \# are discarded. -\subsection{packages} +\featurelabel{profile-file-dirs} For EAPIs listed as supported in table~\ref{tab:profile-file-dirs}, +simple line-based files described in the following sections may optionally be directories containing +files of the named type. + +\ChangeWhenAddingAnEAPI{6} +\begin{centertable}{Profile support for directories of simple line-based files} + \label{tab:profile-file-dirs} + \begin{tabular}{ l l l } + \toprule + \multicolumn{1}{c}{\textbf{EAPI}} & + \multicolumn{1}{c}{\textbf{Supports directories of simple line-based files?}} \\ + \midrule + 0, 1, 2, 3, 4, 5 & No \\ + 6 & Yes \\ + \bottomrule + \end{tabular} +\end{centertable} + +\subsubsection{packages} The \t{packages} file is used to define the `system set' for this profile. After the above rules for inheritance and comments are applied, its lines must take one of two forms: a package dependency specification prefixed by \t{*} denotes that the atom forms part of the system set. A package dependency specification on its own may also appear for legacy reasons, but should be ignored when calculating the system set. -\subsection{packages.build} +\subsubsection{packages.build} The \t{packages.build} file is used by Gentoo's Catalyst tool to generate stage1 tarballs, and has no relevance to the operation of a package manager. It is thus outside the scope of this document, but is mentioned here for completeness. -\subsection{package.mask} +\note At the time of writing, Catalyst does not support \t{packages.build} as a directory. + +\subsubsection{package.mask} \t{package.mask} is used to prevent packages from being installed on a given profile. Each line contains one package dependency specification; anything matching this specification will not be installed unless unmasked by the user's configuration. @@ -93,20 +113,20 @@ necessarily a global mask (from \t{profiles/package.mask}, section~\ref{profiles \note Portage currently treats \t{profiles/package.mask} as being on the leftmost branch of the inherit tree when it comes to \t{-lines}. This behaviour may not be relied upon. -\subsection{package.provided} +\subsubsection{package.provided} \t{package.provided} is used to tell the package manager that a certain package version should be considered to be provided by the system regardless of whether it is actually installed. Because it has severe adverse effects on USE-based and slot-based dependencies, its use is strongly deprecated and package manager support must be regarded as purely optional. -\subsection{package.use} +\subsubsection{package.use} The \t{package.use} file may be used by the package manager to override the default USE flags specified by \t{make.defaults} on a per package basis. The format is to have a package dependency specification, and then a space delimited list of USE flags to enable. A USE flag in the form of \t{-flag} indicates that the package should have the USE flag disabled. The package dependency specification is limited to the forms defined by the directory's EAPI. -\subsection{USE masking and forcing} +\subsubsection{USE masking and forcing} \label{sec:use-masking} This section covers the eight files \t{use.mask}, \t{use.force}, \t{use.stable.mask}, \t{use.stable.force}, \t{package.use.mask}, \t{package.use.force}, \t{package.use.stable.mask},