[gentoo-pms] [PATCH] pkg-mgr-commands.tex: Allow inverted condition in use_with.

[Ulrich Müller]

This allows calls like "use_with !foo bar" or "use_enable !foo bar"
which are supported by all three package managers and widely used in
the tree.

Explicitly forbid the "use_with !foo" one-argument form. It is not
used in the tree, and ebuilds can use the more explicit two-argument
form instead. (Current portage-2.3.46 outputs "--with-!foo".)
---
 pkg-mgr-commands.tex | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index f51e0f0..74c8983 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -846,7 +846,8 @@ table~\ref{tab:use-list-strictness}.
     an empty third argument is treated as if it weren't provided. If the USE flag is set, outputs
     \t{-{}-with-\$\{opt\}=\$\{value\}} if the third argument was provided, and
     \t{-{}-with-\$\{opt\}} otherwise. If the flag is not set, then it outputs
-    \t{-{}-without-\$\{opt\}}.
+    \t{-{}-without-\$\{opt\}}. The condition is inverted if the flag name is prefixed with~\t{!};
+    this is valid only for the two- and three-argument forms.
 \item[use_enable] Works the same as \t{use_with()}, but outputs \t{-{}-enable-} or
     \t{-{}-disable-} instead of \t{-{}-with-} or \t{-{}-without-}.
 \item[usex] \featurelabel{usex} Accepts at least one and at most five arguments. The first argument
-- 
2.18.0