doc use_with/enable empty 3rd arg in EAPI 4

See bug #322049.

diff --git a/doc/package/ebuild/eapi/4.docbook b/doc/package/ebuild/eapi/4.docbook
index bda14348a58c3948435399bff7a6bc66f9db54d7..e5f430fc86bbbe1aa1a11077081294ec32a5c7db 100644 (file)
--- 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 8e493f67a01f836779f1c2599b42eac031ba0f7f..ae2034eb1796be8624ca936f33ef24b5b5cafe3a 100644 (file)
--- 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