Unhide readall and update-reset from manpage.

These are both tools that end-users can find useful on occasion so it
doesn't make sense to hide them.

2 files changed, 6 insertions, 8 deletions

diff --git a/Library/Homebrew/cmd/readall.rb b/Library/Homebrew/cmd/readall.rb
index 9fac52713..3bde16e7e 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 3a9e1caa9..5ba8ec9d8 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