From 7e2979707c6f9c4a91e3a092431ce85b0c226442 Mon Sep 17 00:00:00 2001
From: Adam Vandenberg <flangy@gmail.com>
Date: Sun, 10 Nov 2013 10:33:56 -0800
Subject: [PATCH] document --devel|--HEAD for uses
---
Library/Contributions/manpages/brew.1.md | 6 +++++-
share/man/man1/brew.1 | 5 ++++-
2 files changed, 9 insertions(+), 2 deletions(-)
diff --git a/Library/Contributions/manpages/brew.1.md b/Library/Contributions/manpages/brew.1.md
index de5962ba05..14571be481 100644
--- a/Library/Contributions/manpages/brew.1.md
+++ b/Library/Contributions/manpages/brew.1.md
@@ -346,13 +346,17 @@ Note that these flags should only appear after a command.
If <formulae> are given, upgrade only the specified brews (but do so even
if they are pinned; see `pin`, `unpin`).
- * `uses [--installed] [--recursive]` <formula>:
+ * `uses [--installed] [--recursive] [--devel|--HEAD]` <formula>:
Show the formulae that specify <formula> as a dependency.
Use `--recursive` to resolve more than one level of dependencies.
If `--installed` is passed, only list installed formulae.
+ By default, `uses` shows usages of `formula` by stable builds. To find
+ cases where `formula` is used by development or HEAD build, pass
+ `--devel` or `--HEAD`.
+
* `versions [--compact]` <formulae>:
List previous versions of <formulae>, along with a command to checkout
each version.
diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1
index db596814b6..9034ac80f0 100644
--- a/share/man/man1/brew.1
+++ b/share/man/man1/brew.1
@@ -373,7 +373,7 @@ Options for the \fBinstall\fR command are also valid here\.
If \fIformulae\fR are given, upgrade only the specified brews (but do so even if they are pinned; see \fBpin\fR, \fBunpin\fR)\.
.
.TP
-\fBuses [\-\-installed] [\-\-recursive]\fR \fIformula\fR
+\fBuses [\-\-installed] [\-\-recursive] [\-\-devel|\-\-HEAD]\fR \fIformula\fR
Show the formulae that specify \fIformula\fR as a dependency\.
.
.IP
@@ -382,6 +382,9 @@ Use \fB\-\-recursive\fR to resolve more than one level of dependencies\.
.IP
If \fB\-\-installed\fR is passed, only list installed formulae\.
.
+.IP
+By default, \fBuses\fR shows usages of \fBformula\fR by stable builds\. To find cases where \fBformula\fR is used by development or HEAD build, pass \fB\-\-devel\fR or \fB\-\-HEAD\fR\.
+.
.TP
\fBversions [\-\-compact]\fR \fIformulae\fR
List previous versions of \fIformulae\fR, along with a command to checkout each version\.
--
GitLab