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 4519B13800E for ; Sun, 12 Aug 2012 12:11:43 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 13B2BE011E; Sun, 12 Aug 2012 12:11:25 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id C2B70E011E for ; Sun, 12 Aug 2012 12:11:25 +0000 (UTC) Received: from hornbill.gentoo.org (hornbill.gentoo.org [94.100.119.163]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id D5EF41B4019 for ; Sun, 12 Aug 2012 12:11:24 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id 96AD4E543A for ; Sun, 12 Aug 2012 12:11:23 +0000 (UTC) From: "Ulrich Mueller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Mueller" Message-ID: <1344764700.c54f758c521714561f0ca94d7d185f516b79df59.ulm@gentoo> Subject: [gentoo-commits] proj/pms:eapi-5 commit in: / X-VCS-Repository: proj/pms X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Mueller X-VCS-Revision: c54f758c521714561f0ca94d7d185f516b79df59 X-VCS-Branch: eapi-5 Date: Sun, 12 Aug 2012 12:11:23 +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: e26f5a31-5b2c-4afe-869b-281901732cef X-Archives-Hash: 6c350348f0965de12a8c7d53c78c5e0e commit: c54f758c521714561f0ca94d7d185f516b79df59 Author: Ulrich Müller gentoo org> AuthorDate: Sun Aug 12 09:45:00 2012 +0000 Commit: Ulrich Mueller gentoo org> CommitDate: Sun Aug 12 09:45:00 2012 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/pms.git;a=commit;h=c54f758c Merge branch 'master' into eapi-5 Conflicts: ebuild-vars.tex pms.tex credits.tex | 14 +++----- ebuild-vars.tex | 92 +++++++++++++++++++++++++------------------------- pkg-mgr-commands.tex | 2 +- pms.cls | 17 +-------- pms.tex | 21 +++++++++++ 5 files changed, 75 insertions(+), 71 deletions(-) diff --cc ebuild-vars.tex index a4586bf,1dadc35..7eaabc5 --- a/ebuild-vars.tex +++ b/ebuild-vars.tex @@@ -34,27 -60,24 +60,25 @@@ Ebuilds may define any of the followin \t{IUSE} defaults, any use flag name in \t{IUSE} may be prefixed by at most one of a plus or a minus sign. If such a prefix is present, the package manager may use it as a suggestion as to the default value of the use flag if no other configuration overrides it. - \item[KEYWORDS] A whitespace separated list of keywords for the ebuild. Each token must be a - valid keyword name, as per section~\ref{sec:keyword-names}. May include \t{-*}, which - indicates that the package will only work on explicitly listed archs. May include \t{-arch}, - which indicates that the package will not work on the specified arch. May be empty, which - indicates uncertain functionality on any architecture. May be defined in an eclass. - \item[LICENSE] The package's license. Each text token must correspond to a tree ``licenses/'' entry - (see section~\ref{sec:licenses-dir}). See section~\ref{sec:dependencies} for full syntax. - May be defined by an eclass. \label{ebuild-var-LICENSE} - \item[SLOT] The package's slot. Must be a valid slot name, as per section~\ref{sec:slot-names}. May - be defined by an eclass. Must not be empty. - \item[SRC\_URI] A list of source URIs for the package. Valid protocols are \t{http://}, - \t{https://}, \t{ftp://} and \t{mirror://} (see section~\ref{sec:thirdpartymirrors} for mirror - behaviour). Fetch restricted packages may include URL parts consisting of just a filename. - May be defined by an eclass. See section~\ref{sec:dependencies} for full syntax. + \item[REQUIRED\_USE] \featurelabel{required-use} Zero or more assertions that must be met by the + configuration of \t{USE} flags to be valid for this ebuild. See section~\ref{sec:required-use} + for description and section~\ref{sec:dependencies} for full syntax. Only in EAPIs listed in + table~\ref{tab:optional-vars-table} as supporting \t{REQUIRED\_USE}. + \item[PROPERTIES] \featurelabel{properties} Zero or more properties for this package. + See section~\ref{sec:properties} for value meanings and section~\ref{sec:dependencies} for full + syntax. For EAPIs listed in table~\ref{tab:optional-vars-table} as having optional support, + ebuilds must not rely upon the package manager recognising or understanding this variable in + any way. + \item[RESTRICT] Zero or more behaviour restrictions for this package. See section~\ref{sec:restrict} + for value meanings and section~\ref{sec:dependencies} for full syntax. + \item[DEPEND] See section~\ref{sec:dependencies}. + \item[RDEPEND] See section~\ref{sec:dependencies}. For some EAPIs, \t{RDEPEND} has special behaviour + for its value if unset and when used with an eclass. See section~\ref{sec:rdepend-depend} for + details. + \item[PDEPEND] See section~\ref{sec:dependencies}. \end{description} - If any of these variables are undefined, or if any of these variables are set to invalid values, - the package manager's behaviour is undefined; ideally, an error in one ebuild should not prevent - operations upon other ebuilds or packages. - +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting \t{IUSE} defaults} \label{tab:iuse-defaults-table} \begin{tabular}{ l l } \toprule @@@ -71,31 -93,6 +95,7 @@@ \end{tabular} \end{centertable} - \section{Optional Ebuild-defined Variables} - - Ebuilds may define any of the following variables: - - \begin{description} - \item[DEPEND] See section~\ref{sec:dependencies}. - \item[EAPI] The EAPI. See below. - \item[PDEPEND] See section~\ref{sec:dependencies}. - \item[RDEPEND] See section~\ref{sec:dependencies}. For some EAPIs, \t{RDEPEND} has special behaviour - for its value if unset and when used with an eclass. See section~\ref{sec:rdepend-depend} for - details. - \item[RESTRICT] Zero or more behaviour restrictions for this package. See section~\ref{sec:restrict} - for value meanings and section~\ref{sec:dependencies} for full syntax. - \item[PROPERTIES] \featurelabel{properties} Zero or more properties for this package. See - section~\ref{sec:properties} for value meanings and section~\ref{sec:dependencies} for full - syntax. For EAPIs listed in table~\ref{tab:optional-vars-table} as having optional support, - ebuilds must not rely upon the package manager recognising or understanding this variable in - any way. - \item[REQUIRED\_USE] \featurelabel{required-use} Zero or more assertions that must be met by the - configuration of \t{USE} flags to be valid for this ebuild. See section~\ref{sec:required-use} - for description and section~\ref{sec:dependencies} for full syntax. Only in EAPIs listed in - table~\ref{tab:optional-vars-table} as supporting \t{REQUIRED\_USE}. - \end{description} - +\ChangeWhenAddingAnEAPI{5} \begin{centertable}{EAPIs supporting various ebuild-defined variables} \label{tab:optional-vars-table} \begin{tabular}{ l l l } diff --cc pms.tex index d0ceda2,7244be9..5885c9c --- a/pms.tex +++ b/pms.tex @@@ -1,8 -1,26 +1,29 @@@ \documentclass{pms} + \title{Package Manager Specification} + \author{% + Stephen P. Bennett \\ + \href{mailto:spb@exherbo.org}{spb@exherbo.org} + \and + Christian Faulhammer \\ + \href{mailto:fauli@gentoo.org}{fauli@gentoo.org} + \and + Ciaran McCreesh \\ + \href{mailto:ciaran.mccreesh@googlemail.com}{ciaran.mccreesh@googlemail.com} + \and + Ulrich Müller \\ + \href{mailto:ulm@gentoo.org}{ulm@gentoo.org} + } + \hypersetup{% + pdftitle={Package Manager Specification}, + pdfauthor={Stephen P. Bennett, Christian Faulhammer, Ciaran McCreesh, Ulrich Müller}, + pdfsubject={Defining a feature set for package managers in the Gentoo world}, + pdfkeywords={Gentoo, package manager, specification}, + } + +\CurrentEAPIIs{5} +\ChangeWhenAddingAnEAPI{5} + \begin{document} \maketitle