diff --git a/Library/Contributions/manpages/brew.1.md b/Library/Contributions/manpages/brew.1.md
index 049fc4e2b29fd08d604d22094005fe99ea6e2416..9a7f50b0182aa7b9022bcd66ce509f7aa8ddba7d 100644
--- a/Library/Contributions/manpages/brew.1.md
+++ b/Library/Contributions/manpages/brew.1.md
@@ -233,6 +233,11 @@ For the full command list, see the COMMANDS section.
   * `update`:
     Fetch the newest version of Homebrew from GitHub using `git`(1).
 
+  * `upgrade` [<formulae>]:
+    Upgrade outdated brews.
+
+    If <formulae> are given, upgrade only the specified brews.
+
   * `uses [--installed]` <formula>:
     Show the formulas that specify <formula> as a dependency. The list is
     not recursive; only one level of dependencies is resolved.
diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1
index ea3618dd6c218043041df81f96f692c3ca6806cd..9a940faa7c25542d8a73dc807749fb0d8e3e8473 100644
--- a/share/man/man1/brew.1
+++ b/share/man/man1/brew.1
@@ -259,6 +259,13 @@ Unsymlink \fIformula\fR from the Homebrew prefix\. This can be useful for tempor
 Fetch the newest version of Homebrew from GitHub using \fBgit\fR(1)\.
 .
 .TP
+\fBupgrade\fR [\fIformulae\fR]
+Upgrade outdated brews\.
+.
+.IP
+If \fIformulae\fR are given, upgrade only the specified brews\.
+.
+.TP
 \fBuses [\-\-installed]\fR \fIformula\fR
 Show the formulas that specify \fIformula\fR as a dependency\. The list is not recursive; only one level of dependencies is resolved\.
 .