Merge pull request #13844 from troymccabe/feature/13834-brew-docs-cmd

Adds `brew docs` to close #13834

Library/Homebrew/cmd/docs.rb

@@ -0,0 +1,24 @@
+# typed: true
+# frozen_string_literal: true
+
+require "cli/parser"
+
+module Homebrew
+  extend T::Sig
+
+  module_function
+
+  sig { returns(CLI::Parser) }
+  def docs_args
+    Homebrew::CLI::Parser.new do
+      description <<~EOS
+        Open Homebrew's online documentation (#{HOMEBREW_DOCS_WWW}) in a browser.
+      EOS
+    end
+  end
+
+  sig { void }
+  def docs
+    exec_browser HOMEBREW_DOCS_WWW
+  end
+end

Library/Homebrew/global.rb

@@ -45,6 +45,7 @@
 HOMEBREW_PRODUCT = ENV.fetch("HOMEBREW_PRODUCT").freeze
 HOMEBREW_VERSION = ENV.fetch("HOMEBREW_VERSION").freeze
 HOMEBREW_WWW = "https://brew.sh"
+HOMEBREW_DOCS_WWW = "https://docs.brew.sh"
 HOMEBREW_SYSTEM = ENV.fetch("HOMEBREW_SYSTEM").freeze
 HOMEBREW_PROCESSOR = ENV.fetch("HOMEBREW_PROCESSOR").freeze
 

Library/Homebrew/test/cmd/docs_spec.rb

@@ -0,0 +1,11 @@
+# typed: false
+# frozen_string_literal: true
+
+describe "brew docs" do
+  it "opens the docs page", :integration_test do
+    expect { brew "docs", "HOMEBREW_BROWSER" => "echo" }
+      .to output("https://docs.brew.sh\n").to_stdout
+      .and not_to_output.to_stderr
+      .and be_a_success
+  end
+end