Merge pull request #1205 from MikeMcQuaid/help-external-commands

help: support `#:` help in external commands.

Library/Homebrew/brew.rb

@@ -75,12 +75,9 @@ begin
   end
 
   # Usage instructions should be displayed if and only if one of:
-  # - a help flag is passed AND an internal command is matched
+  # - a help flag is passed AND a command is matched
   # - a help flag is passed AND there is no command specified
   # - no arguments are passed
-  #
-  # It should never affect external commands so they can handle usage
-  # arguments themselves.
   if empty_argv || help_flag
     require "cmd/help"
     Homebrew.help cmd, empty_argv: empty_argv

Library/Homebrew/cmd/help.rb

@@ -39,6 +39,8 @@ module Homebrew
     if cmd
       cmd = HOMEBREW_INTERNAL_COMMAND_ALIASES.fetch(cmd, cmd)
       path = Commands.path(cmd)
+      path ||= which("brew-#{cmd}")
+      path ||= which("brew-#{cmd}.rb")
     end
 
     # Display command-specific (or generic) help in response to `UsageError`.
@@ -61,7 +63,7 @@ module Homebrew
       exit 0
     end
 
-    # Resume execution in `brew.rb` for external/unknown commands.
+    # Resume execution in `brew.rb` for unknown commands.
     return if path.nil?
 
     # Display help for internal command (or generic help if undocumented).