From: "Markos Chandras" <hwoarang@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Subject: [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/eapi/
Date: Sat, 17 Nov 2012 18:59:06 +0000 (UTC) [thread overview]
Message-ID: <1353178698.e5d551695c76d53be869feaf24bed924eee0d025.hwoarang@gentoo> (raw)
commit: e5d551695c76d53be869feaf24bed924eee0d025
Author: Markos Chandras <hwoarang <AT> gentoo <DOT> org>
AuthorDate: Sat Nov 17 15:22:30 2012 +0000
Commit: Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Sat Nov 17 18:58:18 2012 +0000
URL: http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=e5d55169
eapi: Add EAPI 5 information. Bug #438338
---
ebuild-writing/eapi/text.xml | 131 ++++++++++++++++++++++++++++++++++++++++++
1 files changed, 131 insertions(+), 0 deletions(-)
diff --git a/ebuild-writing/eapi/text.xml b/ebuild-writing/eapi/text.xml
index 9fe1cbb..a871067 100644
--- a/ebuild-writing/eapi/text.xml
+++ b/ebuild-writing/eapi/text.xml
@@ -683,6 +683,137 @@ REQUIRED_USE="|| ( foo bar baz )"
</body>
</section>
+<section>
+<title>EAPI=5</title>
+<body>
+
+<subsection>
+<title>Metadata</title>
+<body>
+<ul>
+ <li>
+ <p><b>REQUIRED_USE supports new at-most-one-of operator</b></p>
+ <p>
+ The new <b>at-most-one-of</b> operator consists of the string <c>'??'</c>, and is satisfied if zero or one (but no more) of its child elements is matched.
+ </p>
+ </li>
+ <li>
+ <p><b>SLOT supports optional "sub-slot" part</b></p>
+ <p>
+ The <c>SLOT</c> variable may contain an optional <b>sub-slot</b> part that follows the regular slot and is delimited by a <c>/</c> character. The sub-slot must be a valid slot name. The sub-slot is used to represent cases in which an upgrade to a new version of a package with a different sub-slot may require dependent packages to be rebuilt. When the sub-slot part is omitted from the SLOT definition, the package is considered to have an implicit sub-slot which is equal to the regular slot.
+ </p>
+ </li>
+ <li>
+ <p><b>Dependency atom slot operators</b></p>
+ <p>
+ A slot dependency may contain an optional sub-slot part that follows the regular slot and is delimited by a <c>/</c> character. An operator slot dependency consists of a colon followed by one of the following operators:
+ </p>
+ <ul>
+ <li>
+ <c>*</c> Indicates that any slot value is acceptable. In addition, for runtime dependencies, indicates that the package will not break if the matched package is uninstalled and replaced by a different matching package in a different slot.
+ </li>
+ <li>
+ <c>=</c> Indicates that any slot value is acceptable. In addition, for runtime dependencies, indicates that the package will break unless a matching package with slot and sub-slot equal to the slot and sub-slot of the best installed version at the time the package was installed is available.
+ </li>
+ <li>
+ <c>slot=</c> Indicates that only a specific slot value is acceptable, and otherwise behaves identically to the plain equals slot operator.
+ </li>
+ </ul>
+ </li>
+</ul>
+</body>
+</subsection>
+
+<subsection>
+<title>Profiles</title>
+<body>
+<ul>
+ <li>
+ <p><b>Profile stable USE forcing and masking</b></p>
+ <p>
+ In profile directories with an EAPI supporting stable masking, new USE configuration files are supported: <c>use.stable.mask</c>, <c>use.stable.force</c>, <c>package.use.stable.mask</c> and <c>package.use.stable.force</c>. These files behave similarly to previously supported USE configuration files, except that they only influence packages that are merged due to a stable keyword.
+ </p>
+ </li>
+</ul>
+</body>
+</subsection>
+
+<subsection>
+<title>Helpers</title>
+<body>
+<ul>
+ <li>
+ <p><b>econf adds --disable-silent-rules</b></p>
+ <p>
+ This option will automatically be passed if <c>--disable-silent-rules</c> occurs in the output of <c>configure --help</c>.
+ </p>
+ </li>
+ <li>
+ <p><b>new* commands can read from standard input</b></p>
+ <p>
+ Standard input is read when the first parameter is <c>-</c> (a hyphen).
+ </p>
+ </li>
+ <li>
+ <p><b>New option --host-root for {has,best}_version</b></p>
+ <p>
+ This option <c>--host-root</c> will cause the query to apply to the host root instead of ROOT.
+ </p>
+ </li>
+ <li>
+ <p><b>New doheader helper function</b></p>
+ <p>
+ Installs the given header files into <c>/usr/include/</c>, by default with file mode <c>0644</c>. This can be overridden by setting <c>INSOPTIONS</c> with the <c>insopts</c> function.
+ </p>
+ </li>
+ <li>
+ <p><b>New usex helper function</b></p>
+ <p>
+ <!-- We probably need an example here -->
+ <pre>
+USAGE: usex 〈USE flag〉 [true output] [false output] [true suffix] [false suffix]
+DESCRIPTION:
+If USE flag is set, echo [true output][true suffix] (defaults to "yes"),
+ otherwise echo [false output][false suffix] (defaults to "no").
+ </pre>
+ </p>
+ </li>
+</ul>
+</body>
+</subsection>
+
+<subsection>
+<title>Phases</title>
+<body>
+<ul>
+ <li>
+ <p><b>src_test supports parallel tests</b></p>
+ <p>
+ Unlike older EAPIs, the default <c>src_test</c> implementation will not pass the -j1 option to emake.
+ </p>
+ </li>
+</ul>
+</body>
+</subsection>
+
+<subsection>
+<title>Variables</title>
+<body>
+<ul>
+ <li>
+ <p><b>EBUILD_PHASE_FUNC</b></p>
+ <p>
+ During execution of an ebuild phase function (such as <c>pkg_setup</c> or <c>src_unpack</c>),
+ the <c>EBUILD_PHASE_FUNC</c> variable will contain the name of the phase function that is currently executing.
+ </p>
+ </li>
+</ul>
+</body>
+</subsection>
+
+</body>
+</section>
+
</body>
</chapter>
</guide>
next reply other threads:[~2012-11-17 18:59 UTC|newest]
Thread overview: 34+ messages / expand[flat|nested] mbox.gz Atom feed top
2012-11-17 18:59 Markos Chandras [this message]
-- strict thread matches above, loose matches on Subject: below --
2024-07-05 20:15 [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/eapi/ Ulrich Müller
2022-11-09 12:01 Ulrich Müller
2022-02-25 19:04 Sam James
2022-02-22 7:11 Sam James
2022-02-22 7:11 Sam James
2020-05-09 10:41 Ulrich Müller
2020-01-23 7:47 Ulrich Müller
2020-01-09 7:58 Ulrich Müller
2018-10-24 13:01 Brian Evans
2017-09-25 4:27 Göktürk Yüksek
2017-01-25 0:55 Göktürk Yüksek
2016-12-08 4:07 Göktürk Yüksek
2016-09-08 21:23 Mike Gilbert
2016-04-30 3:09 Göktürk Yüksek
2016-03-24 15:10 Ulrich Müller
2016-02-15 18:00 Ulrich Müller
2016-02-15 12:10 Ulrich Müller
2016-02-15 12:10 Ulrich Müller
2015-11-22 12:37 Ulrich Müller
2014-06-08 17:39 Mike Gilbert
2013-04-30 12:58 Fabian Groffen
2013-01-21 17:27 Pacho Ramos
2013-01-21 8:18 Pacho Ramos
2012-11-17 18:59 Markos Chandras
2012-11-02 17:53 Markos Chandras
2012-10-30 19:01 Markos Chandras
2012-08-31 21:18 Markos Chandras
2011-08-24 20:13 Markos Chandras
2011-03-09 16:42 Jeremy Olexa
2011-02-13 8:23 Torsten Veller
2011-02-04 20:41 darkside
2011-02-04 20:37 darkside
2011-02-04 17:02 darkside
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1353178698.e5d551695c76d53be869feaf24bed924eee0d025.hwoarang@gentoo \
--to=hwoarang@gentoo.org \
--cc=gentoo-commits@lists.gentoo.org \
--cc=gentoo-dev@lists.gentoo.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox