cmd/uses: mention "dependents" in help text

Library/Homebrew/cmd/uses.rb

@@ -15,10 +15,10 @@ module Homebrew
       usage_banner <<~EOS
         `uses` [<options>] <formula>
 
-        Show formulae that specify <formula> as a dependency. When given multiple
-        formula arguments, show the intersection of formulae that use <formula>.
-        By default, `uses` shows all formulae that specify <formula> as a required
-        or recommended dependency for their stable builds.
+        Show formulae that specify <formula> as a dependency (i.e. show dependents
+        of <formula>). When given multiple formula arguments, show the intersection
+        of formulae that use <formula>. By default, `uses` shows all formulae that
+        specify <formula> as a required or recommended dependency for their stable builds.
       EOS
       switch "--recursive",
              description: "Resolve more than one level of dependencies."
@@ -45,6 +45,9 @@ module Homebrew
   def uses
     uses_args.parse
 
+    odeprecated "brew uses --devel" if args.devel?
+    odeprecated "brew uses --HEAD" if args.HEAD?
+
     Formulary.enable_factory_cache!
 
     used_formulae_missing = false

docs/Manpage.md

@@ -559,10 +559,10 @@ the upgraded formulae or, every 30 days, for all formulae.
 
 ### `uses` [*`options`*] *`formula`*
 
-Show formulae that specify *`formula`* as a dependency. When given multiple
-formula arguments, show the intersection of formulae that use *`formula`*. By
-default, `uses` shows all formulae that specify *`formula`* as a required or
-recommended dependency for their stable builds.
+Show formulae that specify *`formula`* as a dependency (i.e. show dependents of
+*`formula`*). When given multiple formula arguments, show the intersection of
+formulae that use *`formula`*. By default, `uses` shows all formulae that specify
+*`formula`* as a required or recommended dependency for their stable builds.
 
 * `--recursive`:
   Resolve more than one level of dependencies.

manpages/brew.1

@@ -723,7 +723,7 @@ Print install times for each formula at the end of the run\.
 Show what would be upgraded, but do not actually upgrade anything\.
 .
 .SS "\fBuses\fR [\fIoptions\fR] \fIformula\fR"
-Show formulae that specify \fIformula\fR as a dependency\. When given multiple formula arguments, show the intersection of formulae that use \fIformula\fR\. By default, \fBuses\fR shows all formulae that specify \fIformula\fR as a required or recommended dependency for their stable builds\.
+Show formulae that specify \fIformula\fR as a dependency (i\.e\. show dependents of \fIformula\fR)\. When given multiple formula arguments, show the intersection of formulae that use \fIformula\fR\. By default, \fBuses\fR shows all formulae that specify \fIformula\fR as a required or recommended dependency for their stable builds\.
 .
 .TP
 \fB\-\-recursive\fR