--- function-reference/query-functions/text.xml	(revision 155)
+++ function-reference/query-functions/text.xml	(working copy)
@@ -23,7 +23,10 @@ 
       <c>use flagname</c>
     </ti>
     <ti>
-      Returns a true value if and only if <c>flagname</c> is included in <c>USE</c>
+      Returns a true value if and only if <c>flagname</c> is enabled.
+      The condition is inverted if prefixed with an exclamation mark,
+      <c>!flagname</c>.
+      It is guaranteed that <c>use</c> produces no output.
     </ti>
   </tr>
   <tr>
@@ -31,7 +34,7 @@ 
       <c>useq flagname</c>
     </ti>
     <ti>
-      As <c>use</c>, guaranteed to produce no output.
+      Deprecated synonym for <c>use</c>.
     </ti>
   </tr>
   <tr>
@@ -65,8 +68,11 @@ 
       <c>has flag string</c>
     </ti>
     <ti>
-      Returns true if <c>flag</c> is included in the flag list <c>string</c> (example:
-      <c>if has ccache $FEATURES ; then</c>).
+      Returns true if <c>flag</c> is included in the flag list <c>string</c>
+      (example: <c>if has ccache $FEATURES ; then</c>).
+      The condition is inverted if prefixed with an exclamation mark,
+      <c>!flag</c>.
+      It is guaranteed that <c>has</c> produces no output.
     </ti>
   </tr>
   <tr>
@@ -74,7 +80,7 @@ 
       <c>hasq flag string</c>
     </ti>
     <ti>
-      As <c>has</c>, guaranteed quiet.
+      Deprecated synonym for <c>has</c>.
     </ti>
   </tr>
   <tr>
--- ebuild-writing/use-conditional-code/text.xml	(revision 155)
+++ ebuild-writing/use-conditional-code/text.xml	(working copy)
@@ -52,9 +52,11 @@ 
 </p>
 
 <p>
-You must not rely upon <c>use</c> producing an output <d/> this no longer happens.
-If you really need output displayed, use the <c>usev</c> function. The
-<c>useq</c> function is available for explicitly requesting no output.
+It is guaranteed that <c>use</c> produces no output. If you need output
+displayed, use the <c>usev</c> function; it echoes the USE flag's name
+if the condition is met.
+The <c>useq</c> function is a deprecated synonym for <c>use</c>, don't
+use it in new code.
 </p>
 </body>
 
--- eclass-writing/text.xml	(revision 155)
+++ eclass-writing/text.xml	(working copy)
@@ -195,7 +195,7 @@ 
 
 domacosapp() {
     [[ -z "${1}" ]] &amp;&amp; die "usage: domacosapp &lt;file&gt; &lt;new file&gt;"
-    if useq ppc-macos ; then
+    if use ppc-macos ; then
         insinto /Applications
         newins "$1" "${2:-${1}}" || die "Failed to install ${1}"
     fi