diff --git a/Library/Contributions/manpages/brew.1.md b/Library/Contributions/manpages/brew.1.md
index 150288c1b0..b151b6f0ab 100644
--- a/Library/Contributions/manpages/brew.1.md
+++ b/Library/Contributions/manpages/brew.1.md
@@ -15,7 +15,8 @@ didn't include with OS X.
 
 For the full command list, see the COMMANDS section.
 
-With `--verbose`, many commands print extra debugging information.
+With `--verbose` or `-v`, many commands print extra debugging information.
+Note that these flags should only appear after a command.
 
   * `install` <formula>:
     Install <formula>.
diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1
index 14a2598954..a7610061eb 100644
--- a/share/man/man1/brew.1
+++ b/share/man/man1/brew.1
@@ -19,7 +19,10 @@ Homebrew is the easiest and most flexible way to install the UNIX tools Apple di
 For the full command list, see the COMMANDS section\.
 .
 .P
-With \fB\-\-verbose\fR, many commands print extra debugging information\.
+With \fB\-\-verbose\fR or \fB\-v\fR, many commands print extra debugging information\.
+.
+.br
+Note that these flags should only appear after a command\.
 .
 .TP
 \fBinstall\fR \fIformula\fR