aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2011-01-02 15:52:01 -0800
committerZac Medico <zmedico@gentoo.org>2011-01-02 15:52:01 -0800
commit490f594ee95d3aa82354f420a1bf5dadfa3a6367 (patch)
treed1c018c4f3ee722ccddb5854aa9d8783bc2acab7
parentDepcleanWithInstalledMasked: fix breakage (diff)
downloadportage-490f594ee95d3aa82354f420a1bf5dadfa3a6367.tar.gz
portage-490f594ee95d3aa82354f420a1bf5dadfa3a6367.tar.bz2
portage-490f594ee95d3aa82354f420a1bf5dadfa3a6367.zip
doc use_with/enable empty 3rd arg in EAPI 4
See bug #322049.
-rw-r--r--doc/package/ebuild/eapi/4.docbook8
-rw-r--r--man/ebuild.58
2 files changed, 14 insertions, 2 deletions
diff --git a/doc/package/ebuild/eapi/4.docbook b/doc/package/ebuild/eapi/4.docbook
index bda14348a..e5f430fc8 100644
--- a/doc/package/ebuild/eapi/4.docbook
+++ b/doc/package/ebuild/eapi/4.docbook
@@ -95,6 +95,14 @@ The econf helper now adds --disable-dependency-tracking to the
configure arguments.
</para>
</section>
+<section id='package-ebuild-eapi-4-helpers-use-with-enable-empty-third-arg'>
+<title>use_with and use_enable support empty third argument</title>
+<para>
+Beginning with EAPI 4, an empty third argument
+is recognized. In EAPI 3 and earlier, an empty third
+argument is treated as if it weren't provided.
+</para>
+</section>
</section>
<section id='package-ebuild-eapi-4-metadata'>
<title>Metadata</title>
diff --git a/man/ebuild.5 b/man/ebuild.5
index 8e493f67a..ae2034eb1 100644
--- a/man/ebuild.5
+++ b/man/ebuild.5
@@ -802,7 +802,9 @@ If \fIconfigure opt\fR is not specified, then just \fI\-\-with\-[configure
name]\fR will be echoed. If \fIUSE item\fR is not in the \fBUSE\fR variable,
then the string \fI\-\-without\-[configure name]\fR will be echoed. If
\fIconfigure name\fR is not specified, then \fIUSE item\fR will be used in
-its place.
+its place. Beginning with \fBEAPI 4\fR, an empty \fIconfigure opt\fR argument
+is recognized. In \fBEAPI 3\fR and earlier, an empty \fIconfigure opt\fR
+argument is treated as if it weren't provided.
.RS
.TP
.I Examples:
@@ -828,7 +830,9 @@ myconf=$(use_with sdl SDL all\-plugins)
\fBuse_enable\fR \fI<USE item>\fR \fI[configure name]\fR \fI[configure opt]\fR
Same as \fBuse_with\fR above, except that the configure options are
\fI\-\-enable\-\fR instead of \fI\-\-with\-\fR and \fI\-\-disable\-\fR instead of
-\fI\-\-without\-\fR.
+\fI\-\-without\-\fR. Beginning with \fBEAPI 4\fR, an empty \fIconfigure opt\fR
+argument is recognized. In \fBEAPI 3\fR and earlier, an empty
+\fIconfigure opt\fR argument is treated as if it weren't provided.
.TP
\fBhas\fR \fI<item>\fR \fI<item list>\fR
If \fIitem\fR is in \fIitem list\fR, then \fIitem\fR is echoed and \fBhas\fR