Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-project
Navigation:
Lists: gentoo-project: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-project@g.o
From: Ulrich Mueller <ulm@g.o>
Subject: Re: Call for agenda items -- Council meeting 2012-05-08
Date: Tue, 24 Apr 2012 21:12:22 +0200
>>>>> 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] <http://archives.gentoo.org/gentoo-pms/msg_ef7635aa655913f2386e64e385f5a6ae.xml>
[2] <http://archives.gentoo.org/gentoo-pms/msg_3a441be5e49cc06689ecab00da461278.xml>
[3] <http://www.gentoo.org/proj/en/glep/#doc_chap4_sect3>
[4] <http://www.gentoo.org/proj/en/council/meeting-logs/20100823-summary.txt>
[5] <http://www.gentoo.org/proj/en/council/meeting-logs/20120403-summary.txt>

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?= <ulm@g.o>
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

References:
Call for agenda items -- Council meeting 2012-05-08
-- Fabian Groffen
Navigation:
Lists: gentoo-project: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Call for agenda items -- Council meeting 2012-05-08
Next by thread:
Re: Call for agenda items -- Council meeting 2012-05-08
Previous by date:
Call for agenda items -- Council meeting 2012-05-08
Next by date:
Re: Call for agenda items -- Council meeting 2012-05-08


Updated Jun 27, 2012

Summary: Archive of the gentoo-project mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.