diff --git a/Library/Homebrew/cmd/readall.rb b/Library/Homebrew/cmd/readall.rb
index 9fac52713d..3bde16e7e2 100644
--- a/Library/Homebrew/cmd/readall.rb
+++ b/Library/Homebrew/cmd/readall.rb
@@ -1,11 +1,9 @@
-#: @hide_from_man_page
 #:  * `readall` [tap]:
-#:    Import all formulae from specified taps (defaults to
-#:    all installed taps).
+#:    Import all formulae from specified taps (defaults to all installed taps).
 #:
-#:    This can be useful for debugging issues across all formulae
-#:    when making significant changes to `formula.rb`,
-#:    or to determine if any current formulae have Ruby issues.
+#:    This can be useful for debugging issues across all formulae when making
+#:    significant changes to `formula.rb`, testing the performance of loading
+#:    all formulae or to determine if any current formulae have Ruby issues.
 
 require "readall"
 
diff --git a/Library/Homebrew/cmd/update-reset.sh b/Library/Homebrew/cmd/update-reset.sh
index 3a9e1caa93..5ba8ec9d82 100644
--- a/Library/Homebrew/cmd/update-reset.sh
+++ b/Library/Homebrew/cmd/update-reset.sh
@@ -1,7 +1,7 @@
-#: @hide_from_man_page
 #:  * `update-reset`:
 #:    Fetches and resets Homebrew and all tap repositories using `git`(1) to
-#:    their latest `origin/master`.
+#:    their latest `origin/master`. Note this will destroy all your uncommitted
+#:    or committed changes.
 
 homebrew-update-reset() {
   local DIR
diff --git a/docs/Manpage.md b/docs/Manpage.md
index 59969a3e85..2fe0016d9f 100644
--- a/docs/Manpage.md
+++ b/docs/Manpage.md
@@ -386,6 +386,13 @@ With `--verbose` or `-v`, many commands print extra debugging information. Note
     If `--dry-run` or `-n` is passed, show what would be removed, but do not
     actually remove anything.
 
+  * `readall` [tap]:
+    Import all formulae from specified taps (defaults to all installed taps).
+
+    This can be useful for debugging issues across all formulae when making
+    significant changes to `formula.rb`, testing the performance of loading
+    all formulae or to determine if any current formulae have Ruby issues.
+
   * `reinstall` `formula`:
     Uninstall and then install `formula`.
 
@@ -553,6 +560,11 @@ With `--verbose` or `-v`, many commands print extra debugging information. Note
     If `--force` (or `-f`) is specified then always do a slower, full update check even
     if unnecessary.
 
+  * `update-reset`:
+    Fetches and resets Homebrew and all tap repositories using `git`(1) to
+    their latest `origin/master`. Note this will destroy all your uncommitted
+    or committed changes.
+
   * `upgrade` [`install-options`] [`--cleanup`] [`--fetch-HEAD`] [`formulae`]:
     Upgrade outdated, unpinned brews.
 
diff --git a/manpages/brew-cask.1 b/manpages/brew-cask.1
index f2acf1842c..b34249d69c 100644
--- a/manpages/brew-cask.1
+++ b/manpages/brew-cask.1
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "BREW\-CASK" "1" "September 2017" "Homebrew" "brew-cask"
+.TH "BREW\-CASK" "1" "October 2017" "Homebrew" "brew-cask"
 .
 .SH "NAME"
 \fBbrew\-cask\fR \- a friendly binary installer for macOS
diff --git a/manpages/brew.1 b/manpages/brew.1
index 69ee416d72..a8dde6102e 100644
--- a/manpages/brew.1
+++ b/manpages/brew.1
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "BREW" "1" "September 2017" "Homebrew" "brew"
+.TH "BREW" "1" "October 2017" "Homebrew" "brew"
 .
 .SH "NAME"
 \fBbrew\fR \- The missing package manager for macOS
@@ -398,6 +398,13 @@ Remove dead symlinks from the Homebrew prefix\. This is generally not needed, bu
 If \fB\-\-dry\-run\fR or \fB\-n\fR is passed, show what would be removed, but do not actually remove anything\.
 .
 .TP
+\fBreadall\fR [tap]
+Import all formulae from specified taps (defaults to all installed taps)\.
+.
+.IP
+This can be useful for debugging issues across all formulae when making significant changes to \fBformula\.rb\fR, testing the performance of loading all formulae or to determine if any current formulae have Ruby issues\.
+.
+.TP
 \fBreinstall\fR \fIformula\fR
 Uninstall and then install \fIformula\fR\.
 .
@@ -572,6 +579,10 @@ If \fB\-\-merge\fR is specified then \fBgit merge\fR is used to include updates
 If \fB\-\-force\fR (or \fB\-f\fR) is specified then always do a slower, full update check even if unnecessary\.
 .
 .TP
+\fBupdate\-reset\fR
+Fetches and resets Homebrew and all tap repositories using \fBgit\fR(1) to their latest \fBorigin/master\fR\. Note this will destroy all your uncommitted or committed changes\.
+.
+.TP
 \fBupgrade\fR [\fIinstall\-options\fR] [\fB\-\-cleanup\fR] [\fB\-\-fetch\-HEAD\fR] [\fIformulae\fR]
 Upgrade outdated, unpinned brews\.
 .