diff --git a/Library/Homebrew/cmd/upgrade.rb b/Library/Homebrew/cmd/upgrade.rb
index ada3ca5e54..f170d1f220 100644
--- a/Library/Homebrew/cmd/upgrade.rb
+++ b/Library/Homebrew/cmd/upgrade.rb
@@ -4,7 +4,7 @@
 #:    Options for the `install` command are also valid here.
 #:
 #:    If `--cleanup` is specified or `HOMEBREW_UPGRADE_CLEANUP` is set then remove
-#:    previously installed <formula> version(s).
+#:    previously installed version(s) of upgraded <formulae>.
 #:
 #:    If `--fetch-HEAD` is passed, fetch the upstream repository to detect if
 #:    the HEAD installation of the formula is outdated. Otherwise, the
diff --git a/docs/Manpage.md b/docs/Manpage.md
index ef9a188664..d716efd57a 100644
--- a/docs/Manpage.md
+++ b/docs/Manpage.md
@@ -576,7 +576,7 @@ With `--verbose` or `-v`, many commands print extra debugging information. Note
     Options for the `install` command are also valid here.
 
     If `--cleanup` is specified or `HOMEBREW_UPGRADE_CLEANUP` is set then remove
-    previously installed `formula` version(s).
+    previously installed version(s) of upgraded `formulae`.
 
     If `--fetch-HEAD` is passed, fetch the upstream repository to detect if
     the HEAD installation of the formula is outdated. Otherwise, the
diff --git a/manpages/brew.1 b/manpages/brew.1
index 9ebdc66b90..fee4bd3757 100644
--- a/manpages/brew.1
+++ b/manpages/brew.1
@@ -524,7 +524,7 @@ If \fB\-\-force\fR (or \fB\-f\fR) is specified then always do a slower, full upd
 Options for the \fBinstall\fR command are also valid here\.
 .
 .IP
-If \fB\-\-cleanup\fR is specified or \fBHOMEBREW_UPGRADE_CLEANUP\fR is set then remove previously installed \fIformula\fR version(s)\.
+If \fB\-\-cleanup\fR is specified or \fBHOMEBREW_UPGRADE_CLEANUP\fR is set then remove previously installed version(s) of upgraded \fIformulae\fR\.
 .
 .IP
 If \fB\-\-fetch\-HEAD\fR is passed, fetch the upstream repository to detect if the HEAD installation of the formula is outdated\. Otherwise, the repository\'s HEAD will be checked for updates when a new stable or devel version has been released\.