From de3edd1c24e73a438c6a3b336a3c4325321dec20 Mon Sep 17 00:00:00 2001
From: Seeker <meaningseeking@protonmail.com>
Date: Mon, 20 Jul 2020 08:08:13 -0700
Subject: [PATCH] cmd/uses: mention "dependents" in help text
---
Library/Homebrew/cmd/uses.rb | 11 +++++++----
docs/Manpage.md | 8 ++++----
manpages/brew.1 | 2 +-
3 files changed, 12 insertions(+), 9 deletions(-)
diff --git a/Library/Homebrew/cmd/uses.rb b/Library/Homebrew/cmd/uses.rb
index 8d2bc18040..0186bc9b9b 100644
--- a/Library/Homebrew/cmd/uses.rb
+++ b/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
diff --git a/docs/Manpage.md b/docs/Manpage.md
index ca46a02513..66f171def7 100644
--- a/docs/Manpage.md
+++ b/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.
diff --git a/manpages/brew.1 b/manpages/brew.1
index e5643fde82..fa125d5907 100644
--- a/manpages/brew.1
+++ b/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
--
GitLab