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 1SRpo6-0007BP-Kd for garchives@archives.gentoo.org; Tue, 08 May 2012 19:10:47 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 03787E06B4; Tue, 8 May 2012 19:10:33 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id CA3B0E06B4 for ; Tue, 8 May 2012 19:10:33 +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 1712D1B401E for ; Tue, 8 May 2012 19:10:33 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id D4FC9E542D for ; Tue, 8 May 2012 19:10:31 +0000 (UTC) From: "Ulrich Mueller" To: gentoo-commits@lists.gentoo.org Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Mueller" Message-ID: <1336348231.5ef86ba1e5962154db37d2af806e45de6027884b.ulm@gentoo> Subject: [gentoo-commits] proj/pms:master commit in: / X-VCS-Repository: proj/pms X-VCS-Files: ebuild-vars.tex X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Mueller X-VCS-Revision: 5ef86ba1e5962154db37d2af806e45de6027884b X-VCS-Branch: master Date: Tue, 8 May 2012 19:10:31 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: quoted-printable X-Archives-Salt: 4d6d5062-0a50-42b4-a41c-ba0912a502c2 X-Archives-Hash: d03c28e672437b252b80681f49b693b9 commit: 5ef86ba1e5962154db37d2af806e45de6027884b Author: Ulrich M=C3=BCller gentoo org> AuthorDate: Sun Apr 15 10:15:46 2012 +0000 Commit: Ulrich Mueller gentoo org> CommitDate: Sun May 6 23:50:31 2012 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=3Dproj/pms.git;a=3Dc= ommit;h=3D5ef86ba1 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: =20 \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{RD= EPEND} has special behaviour for its value if unset and when used with an eclass. See section~\re= f{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. =20 +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=3D(['"]?)([A-Za-z0-9+_.-]*)\1[ \t]*(#.*)?$ +\end{verbatim} + +The package manager may optionally determine the EAPI of an ebuild by pa= rsing its first non-blank +and non-comment line, using above regular expression. If a recognised EA= PI has been determined +such, then the package manager must make sure that the \t{EAPI} value ob= tained by sourcing the +ebuild with bash is identical to the EAPI obtained by parsing. The ebuil= d must be treated as +invalid if these values are different. + \subsection{\t{RDEPEND} value} \label{sec:rdepend-depend} =20