From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1SMmu6-0008G3-Jh for garchives@archives.gentoo.org; Tue, 24 Apr 2012 21:04:07 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 2FB42E0841 for ; Tue, 24 Apr 2012 21:04:06 +0000 (UTC) Received: from a1iwww1.kph.uni-mainz.de (a1iwww1.kph.uni-mainz.de [134.93.134.1]) by pigeon.gentoo.org (Postfix) with ESMTP id 4F50EE07FE for ; Tue, 24 Apr 2012 19:12:23 +0000 (UTC) Received: from a1i15.kph.uni-mainz.de (a1i15.kph.uni-mainz.de [134.93.134.92]) by a1iwww1.kph.uni-mainz.de (8.14.4/8.13.4) with ESMTP id q3OJCNrd003785 for ; Tue, 24 Apr 2012 21:12:23 +0200 Received: from a1i15.kph.uni-mainz.de (localhost [127.0.0.1]) by a1i15.kph.uni-mainz.de (8.14.5/8.14.2) with ESMTP id q3OJCMvg025903; Tue, 24 Apr 2012 21:12:22 +0200 Received: (from ulm@localhost) by a1i15.kph.uni-mainz.de (8.14.5/8.14.5/Submit) id q3OJCMQ6025901; Tue, 24 Apr 2012 21:12:22 +0200 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Project discussion list X-BeenThere: gentoo-project@lists.gentoo.org Reply-To: gentoo-project@lists.gentoo.org MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="----cutting-here-may-damage-your-screen-surface----36567501----" Content-Transfer-Encoding: 7bit Message-ID: <20374.64278.586307.448003@a1i15.kph.uni-mainz.de> Date: Tue, 24 Apr 2012 21:12:22 +0200 To: gentoo-project@lists.gentoo.org Subject: Re: [gentoo-project] Call for agenda items -- Council meeting 2012-05-08 In-Reply-To: <20120424182141.GQ10282@gentoo.org> References: <20120424182141.GQ10282@gentoo.org> X-Mailer: VM 8.2.0b under 23.4.2 (x86_64-pc-linux-gnu) From: Ulrich Mueller X-Archives-Salt: 71d83e51-b005-439f-bd64-c50f1f265895 X-Archives-Hash: e6eafd6be25794ca503e0ac9d6968cd3 ------cutting-here-may-damage-your-screen-surface----36567501---- Content-Type: text/plain; charset=us-ascii Content-Description: message body text Content-Transfer-Encoding: 7bit >>>>> On Tue, 24 Apr 2012, Fabian Groffen wrote: > In two weeks from now, the council will meet again. This is the time > to raise and prepare items that the council should put on the agenda > to vote on. I would like the council to vote on the following two topics: 1. Following up to last month's topic "EAPI specification in ebuilds", the exact specification for PMS has been discussed in the gentoo-pms mailing list. See the full thread in [1], and the final wording in [2]. (For convenience, it is also attached to this message as plain text and as git-formatted patch.) 2. Related to this: GLEP 55 is still tagged as "Draft" [3]. Considering previous council decisions [4,5] on the subject, I suggest that its status is changed to "Rejected". Ulrich [1] [2] [3] [4] [5] ------cutting-here-may-damage-your-screen-surface----36567501---- Content-Type: text/plain; name="0001-Specify-syntax-of-EAPI-assignment-for-parsing-by-pac.patch" Content-Disposition: inline; filename="0001-Specify-syntax-of-EAPI-assignment-for-parsing-by-pac.patch" Content-Transfer-Encoding: 7bit If the EAPI is to be specified in an ebuild, the EAPI variable must be assigned to precisely once. The assignment must not be preceded by any lines other than blank lines or those that start with optional whitespace (spaces or tabs) followed by a # character, and the line containing the assignment statement must match the following regular expression: ^[ \t]*EAPI=(['"]?)([A-Za-z0-9+_.-]*)\1[ \t]*(#.*)?$ The package manager may optionally determine the EAPI of an ebuild by parsing its first non-blank and non-comment line, using above regular expression. If a recognised EAPI has been determined such, then the package manager must make sure that the EAPI value obtained by sourcing the ebuild with bash is identical to the EAPI obtained by parsing. The ebuild must be treated as invalid if these values are different. >From c52a11a8e28eb81c6f40e0edcfea65c68bcb2a82 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ulrich=20M=C3=BCller?= Date: Sun, 15 Apr 2012 12:15:46 +0200 Subject: [PATCH] Specify syntax of EAPI assignment for parsing by package managers. --- ebuild-vars.tex | 16 +++++++++++++++- 1 files changed, 15 insertions(+), 1 deletions(-) diff --git a/ebuild-vars.tex b/ebuild-vars.tex index d971234..f3b72bf 100644 --- a/ebuild-vars.tex +++ b/ebuild-vars.tex @@ -75,7 +75,7 @@ Ebuilds may define any of the following variables: \begin{description} \item[DEPEND] See section~\ref{sec:dependencies}. -\item[EAPI] The EAPI. See below for defaults. +\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 @@ -124,6 +124,20 @@ ensure that it is unset. 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. +If the EAPI is to be specified in an ebuild, the \t{EAPI} variable must be assigned to precisely +once. The assignment must not be preceded by any lines other than blank lines or those that start +with optional whitespace (spaces or tabs) followed by a \t{\#} character, and the line containing +the assignment statement must match the following regular expression: +\begin{verbatim} +^[ \t]*EAPI=(['"]?)([A-Za-z0-9+_.-]*)\1[ \t]*(#.*)?$ +\end{verbatim} + +The package manager may optionally determine the EAPI of an ebuild by parsing its first non-blank +and non-comment line, using above regular expression. If a recognised EAPI has been determined +such, then the package manager must make sure that the \t{EAPI} value obtained by sourcing the +ebuild with bash is identical to the EAPI obtained by parsing. The ebuild must be treated as +invalid if these values are different. + \subsection{\t{RDEPEND} value} \label{sec:rdepend-depend} -- 1.7.8.5 ------cutting-here-may-damage-your-screen-surface----36567501------