From 5645c4390128c0a174290d9727195b97a894088e Mon Sep 17 00:00:00 2001 From: Zac Medico Date: Tue, 11 Sep 2012 21:26:49 -0700 Subject: Add EAPI 5_pre2 with features approved by council In the 9/11 council meeting, they approved everything in EAPI 5_pre1 except user patches. So, add EAPI 5_pre2 which is identical to EAPI 5_pre1 but with user patches (apply_user_patches) support removed. --- doc/package/ebuild/eapi/5.docbook | 68 ++++++++++++--------------------------- 1 file changed, 20 insertions(+), 48 deletions(-) (limited to 'doc/package/ebuild/eapi/5.docbook') diff --git a/doc/package/ebuild/eapi/5.docbook b/doc/package/ebuild/eapi/5.docbook index 0894eba2a..c910092c6 100644 --- a/doc/package/ebuild/eapi/5.docbook +++ b/doc/package/ebuild/eapi/5.docbook @@ -1,8 +1,8 @@ -
-EAPI 5_pre1 -
+
+EAPI 5_pre2 +
Metadata -
+
REQUIRED_USE supports new at-most-one-of operator The new at-most-one-of operator consists of the string '??', @@ -10,7 +10,7 @@ and is satisfied if zero or one (but no more) of its child elements is matched.
-
+
SLOT supports optional "sub-slot" part The SLOT variable may contain an optional sub-slot part that @@ -24,11 +24,11 @@ implicit sub-slot which is equal to the regular slot. Refer to the - + slot operators documentation for more information about sub-slot usage.
-
+
Dependency atom slot operators A slot dependency may contain an optional sub-slot part that @@ -70,9 +70,9 @@ the regular slot).
-
+
Profiles -
+
Profile IUSE Injection IUSE_EFFECTIVE is a variable calculated from IUSE and @@ -156,7 +156,7 @@ equivalent of ${v}.
-
+
Profile stable USE forcing and masking In profile directories with an EAPI supporting stable masking, @@ -168,29 +168,29 @@ only influence packages that are merged due to a stable keyword.
-
+
Helpers -
+
econf adds --disable-silent-rules This option will automatically be passed if --disable-silent-rules occurs in the output of configure --help.
-
+
new* commands can read from standard input Standard input is read when the first parameter is - (a hyphen).
-
+
New option --host-root for {has,best}_version This option --host-root will cause the query to apply to the host root instead of ROOT.
-
+
New doheader helper function Installs the given header files into /usr/include/, by default @@ -198,7 +198,7 @@ with file mode 0644. This can be overridden by setting INSOPTIONS with the insopts function.
-
+
New usex helper function USAGE: usex <USE flag> [true output] [false output] [true suffix] [false suffix] @@ -207,38 +207,10 @@ DESCRIPTION: otherwise echo [false output][false suffix] (defaults to "no").
-
-New apply_user_patches helper function - -This function is called to indicate to the package manager -that now would be a suitable time to apply any user patches -to the work directory. This function must return zero if it -is possible that any changes were made to the work directory, -and may return non-zero if no changes were made. This function -must be called at least once in src_prepare; if the function -is called more than once, it is expected that any effects that -it has shall only be executed once, and that its return value -shall only be zero once. -
-
-
+
Phases -
-src_prepare must call apply_user_patches - -If the src_prepare function is implemented then it must call -the apply_user_patches function at least once. If src_prepare -does not call apply_user_patches before it returns, then it will -be treated as a fatal error. The default src_prepare -implementation will call apply_user_patches automatically. -Refer to the - -apply_user_patches section for additional usage -instructions. - -
-
+
src_test supports parallel tests Unlike older EAPIs, the default src_test implementation will not @@ -246,9 +218,9 @@ pass the -j1 option to emake.
-
+
Ebuild Environment Variables -
+
New EBUILD_PHASE_FUNC variable During execution of an ebuild phase function (such as pkg_setup -- cgit v1.2.3-18-g5258