diff --git a/Library/Homebrew/completions/bash.erb b/Library/Homebrew/completions/bash.erb
index 1cdb120743..936bdd3abc 100644
--- a/Library/Homebrew/completions/bash.erb
+++ b/Library/Homebrew/completions/bash.erb
@@ -12,8 +12,10 @@
 # When done, regenerate the completions by running `brew generate-man-completions`.
 %>
 # Bash completion script for brew(1)
+# This file is automatically generated by running `brew generate-man-completions`.
+# See Library/Homebrew/completions/bash.erb for editing instructions.
 
-if test -v POSIXLY_CORRECT || test -o posix 
+if [[ -n ${POSIXLY_CORRECT} ]] || shopt -oq posix
 then
   echo "Homebrew Bash completions do not work in POSIX mode" 1>&2
   return
diff --git a/Library/Homebrew/completions/fish.erb b/Library/Homebrew/completions/fish.erb
index f14ef8f2da..17ffdef9ff 100644
--- a/Library/Homebrew/completions/fish.erb
+++ b/Library/Homebrew/completions/fish.erb
@@ -12,6 +12,8 @@
 # When done, regenerate the completions by running `brew generate-man-completions`.
 %>
 # Fish shell completions for Homebrew
+# This file is automatically generated by running `brew generate-man-completions`.
+# See Library/Homebrew/completions/fish.erb for editing instructions.
 
 # A note about aliases:
 #
diff --git a/Library/Homebrew/completions/zsh.erb b/Library/Homebrew/completions/zsh.erb
index 1049d9f01a..30e2390ae3 100644
--- a/Library/Homebrew/completions/zsh.erb
+++ b/Library/Homebrew/completions/zsh.erb
@@ -15,6 +15,8 @@
 #autoload
 
 # Brew ZSH completion function
+# This file is automatically generated by running `brew generate-man-completions`.
+# See Library/Homebrew/completions/zsh.erb for editing instructions.
 
 # functions starting with __brew are helper functions that complete or list
 #   various types of items.
diff --git a/Library/Homebrew/manpages/brew.1.md.erb b/Library/Homebrew/manpages/brew.1.md.erb
index bd0d68ea7c..79c54d0e77 100644
--- a/Library/Homebrew/manpages/brew.1.md.erb
+++ b/Library/Homebrew/manpages/brew.1.md.erb
@@ -26,7 +26,7 @@ brew(1) -- The Missing Package Manager for macOS (or Linux)
 
 Homebrew is the easiest and most flexible way to install the UNIX tools Apple
 didn't include with macOS. It can also install software not packaged for your
-Linux distribution to your home directory without requiring `sudo`.
+Linux distribution without requiring `sudo`.
 
 ## TERMINOLOGY
 
diff --git a/completions/bash/brew b/completions/bash/brew
index 5d79136756..9ef26c45f9 100644
--- a/completions/bash/brew
+++ b/completions/bash/brew
@@ -1,4 +1,6 @@
 # Bash completion script for brew(1)
+# This file is automatically generated by running `brew generate-man-completions`.
+# See Library/Homebrew/completions/bash.erb for editing instructions.
 
 if [[ -n ${POSIXLY_CORRECT} ]] || shopt -oq posix
 then
diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish
index 4dbecde495..d99cb40304 100644
--- a/completions/fish/brew.fish
+++ b/completions/fish/brew.fish
@@ -1,4 +1,6 @@
 # Fish shell completions for Homebrew
+# This file is automatically generated by running `brew generate-man-completions`.
+# See Library/Homebrew/completions/fish.erb for editing instructions.
 
 # A note about aliases:
 #
diff --git a/completions/zsh/_brew b/completions/zsh/_brew
index d1ff0a9881..1451c566c8 100644
--- a/completions/zsh/_brew
+++ b/completions/zsh/_brew
@@ -2,6 +2,8 @@
 #autoload
 
 # Brew ZSH completion function
+# This file is automatically generated by running `brew generate-man-completions`.
+# See Library/Homebrew/completions/zsh.erb for editing instructions.
 
 # functions starting with __brew are helper functions that complete or list
 #   various types of items.
diff --git a/docs/Manpage.md b/docs/Manpage.md
index 9ccccae78f..4116966b5f 100644
--- a/docs/Manpage.md
+++ b/docs/Manpage.md
@@ -10,7 +10,7 @@ brew(1) -- The Missing Package Manager for macOS (or Linux)
 
 Homebrew is the easiest and most flexible way to install the UNIX tools Apple
 didn't include with macOS. It can also install software not packaged for your
-Linux distribution to your home directory without requiring `sudo`.
+Linux distribution without requiring `sudo`.
 
 ## TERMINOLOGY
 
diff --git a/manpages/brew.1 b/manpages/brew.1
index 472bd723cf..61b5995e61 100644
--- a/manpages/brew.1
+++ b/manpages/brew.1
@@ -13,7 +13,7 @@
 \fBbrew\fR \fIcommand\fR [\fB\-\-verbose\fR|\fB\-v\fR] [\fIoptions\fR] [\fIformula\fR] \.\.\.
 .
 .SH "DESCRIPTION"
-Homebrew is the easiest and most flexible way to install the UNIX tools Apple didn\'t include with macOS\. It can also install software not packaged for your Linux distribution to your home directory without requiring \fBsudo\fR\.
+Homebrew is the easiest and most flexible way to install the UNIX tools Apple didn\'t include with macOS\. It can also install software not packaged for your Linux distribution without requiring \fBsudo\fR\.
 .
 .SH "TERMINOLOGY"
 \fBformula\fR