Merge pull request #8044 from SeekingMeaning/uses+dependents

cmd/uses: mention "dependents" in help text
This commit is contained in:
Seeker 2020-07-22 10:44:44 -07:00 committed by GitHub
commit fb2e228e9a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 12 additions and 9 deletions

View File

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

View File

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

View File

@ -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\. Show what would be upgraded, but do not actually upgrade anything\.
. .
.SS "\fBuses\fR [\fIoptions\fR] \fIformula\fR" .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 .TP
\fB\-\-recursive\fR \fB\-\-recursive\fR