diff --git a/Library/Homebrew/cmd/upgrade.rb b/Library/Homebrew/cmd/upgrade.rb
index 64674d8280..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 <formulae> 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 f343c2ca8a..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 `formulae` 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