formatting fixes

Library/Homebrew/build.rb

@@ -125,7 +125,7 @@ class Build
         end
         if ARGV.interactive?
           ohai "Entering interactive mode"
-          puts "Type `exit' to return and finalize the installation"
+          puts "Type `exit` to return and finalize the installation"
           puts "Install to this prefix: #{formula.prefix}"
 
           if ARGV.git?

Library/Homebrew/cask/artifact/abstract_artifact.rb

@@ -92,7 +92,7 @@ module Cask
         unless unknown_keys.empty?
           opoo "Unknown arguments to #{description} -- " \
                "#{unknown_keys.inspect} (ignored). Running " \
-               "\"brew update; brew cleanup\" will likely fix it."
+               "`brew update; brew cleanup` will likely fix it."
         end
         arguments.select! { |k| permitted_keys.include?(k) }
 

Library/Homebrew/cask/cmd/doctor.rb

@@ -52,7 +52,7 @@ module Cask
           puts self.class.none_string
         else
           locations.map do |l|
-            add_error "Legacy install at #{l}. Run \"brew uninstall --force brew-cask\"."
+            add_error "Legacy install at #{l}. Run `brew uninstall --force brew-cask`."
             puts l
           end
         end

Library/Homebrew/cask/dsl/caveats.rb

@@ -81,7 +81,7 @@ module Cask
 
         <<~EOS
           Cask #{@cask} installs files under /usr/local. The presence of such
-          files can cause warnings when running "brew doctor", which is considered
+          files can cause warnings when running `brew doctor`, which is considered
           to be a bug in Homebrew Cask.
         EOS
       end
@@ -131,14 +131,14 @@ module Cask
       caveat :license do |web_page|
         <<~EOS
           Installing #{@cask} means you have AGREED to the license at:
-            #{web_page}
+            #{Formatter.url(web_page.to_s)}
         EOS
       end
 
       caveat :free_license do |web_page|
         <<~EOS
           The vendor offers a free license for #{@cask} at:
-            #{web_page}
+            #{Formatter.url(web_page.to_s)}
         EOS
       end
     end

Library/Homebrew/cask/exceptions.rb

@@ -138,7 +138,7 @@ module Cask
 
         To retry an incomplete download, remove the file above. If the issue persists, visit:
 
-          https://github.com/Homebrew/homebrew-cask/blob/master/doc/reporting_bugs/checksum_does_not_match_error.md
+          #{Formatter.url("https://github.com/Homebrew/homebrew-cask/blob/master/doc/reporting_bugs/checksum_does_not_match_error.md")}
       EOS
     end
   end

Library/Homebrew/cmd/sh.rb

@@ -48,7 +48,7 @@ module Homebrew
       gem and pip will ignore our configuration and insist on using the
       environment they were built under (mostly). Sadly, scons will also
       ignore our configuration.
-      When done, type `exit'.
+      When done, type `exit`.
     EOS
     $stdout.flush
     safe_system ENV["SHELL"]

Library/Homebrew/dev-cmd/edit.rb

@@ -24,8 +24,8 @@ module Homebrew
     unless (HOMEBREW_REPOSITORY/".git").directory?
       raise <<~EOS
         Changes will be lost!
-        The first time you `brew update', all local changes will be lost; you should
-        thus `brew update' before you `brew edit'!
+        The first time you `brew update`, all local changes will be lost; you should
+        thus `brew update` before you `brew edit`!
       EOS
     end
 

Library/Homebrew/development_tools.rb

@@ -20,7 +20,7 @@ class DevelopmentTools
     end
 
     def installation_instructions
-      "Install Clang or brew install gcc"
+      "Install Clang or run `brew install gcc`."
     end
     alias custom_installation_instructions installation_instructions
 

Library/Homebrew/extend/os/linux/requirements/osxfuse_requirement.rb

@@ -21,7 +21,7 @@ class OsxfuseRequirement < Requirement
     msg = "libfuse is required to install this formula.\n"
     if libfuse_formula_exists?
       msg + <<~EOS
-        Run "brew install libfuse" to install it.
+        Run `brew install libfuse` to install it.
       EOS
     else
       msg + super

Library/Homebrew/extend/os/mac/diagnostic.rb

@@ -306,7 +306,7 @@ module Homebrew
         <<~EOS
           You have installed Bitdefender. The "Traffic Scan" option interferes with
           Homebrew's ability to download packages. See:
-            https://github.com/Homebrew/brew/issues/5558
+            #{Formatter.url("https://github.com/Homebrew/brew/issues/5558")}
         EOS
       end
 

Library/Homebrew/formula.rb

@@ -2343,7 +2343,7 @@ class Formula
     # <pre># If a dependency is only needed in certain cases:
     # depends_on "sqlite" if MacOS.version == :mavericks
     # depends_on :xcode # If the formula really needs full Xcode.
-    # depends_on :macos => :mojave # Needs at least OS X Lion (10.14).
+    # depends_on :macos => :mojave # Needs at least macOS Mojave (10.14).
     # depends_on :x11 => :optional # X11/XQuartz components.
     # depends_on :osxfuse # Permits the use of the upstream signed binary or our source package.
     # depends_on :tuntap # Does the same thing as above. This is vital for Yosemite and above.</pre>

Library/Homebrew/migrator.rb

@@ -231,7 +231,7 @@ class Migrator
         end
       end
 
-      odie "Remove #{new_cellar} manually and run brew migrate #{oldname}." if conflicted
+      odie "Remove #{new_cellar} manually and run `brew migrate #{oldname}`." if conflicted
     end
 
     oh1 "Moving #{Formatter.identifier(oldname)} versions to #{new_cellar}"

Library/Homebrew/missing_formula.rb

@@ -189,7 +189,7 @@ module Homebrew
               git -C "$(brew --repo #{tap})" show #{short_hash}^:#{relative_path}
 
             If you still use this formula consider creating your own tap:
-              https://docs.brew.sh/How-to-Create-and-Maintain-a-Tap
+              #{Formatter.url("https://docs.brew.sh/How-to-Create-and-Maintain-a-Tap")}
           EOS
         end
       end

Library/Homebrew/os/mac.rb

@@ -212,7 +212,7 @@ module OS
         Homebrew doesn't know what compiler versions ship with your version
         of Xcode (#{Xcode.version}). Please `brew update` and if that doesn't
         help, file an issue with the output of `brew --config`:
-          https://github.com/Homebrew/brew/issues
+          #{Formatter.url("https://github.com/Homebrew/brew/issues")}
 
         Note that we only track stable, released versions of Xcode.
 

Library/Homebrew/os/mac/xcode.rb

@@ -107,7 +107,7 @@ module OS
         if OS::Mac.prerelease?
           <<~EOS
             Xcode can be updated from:
-              https://developer.apple.com/download/more/
+              #{Formatter.url("https://developer.apple.com/download/more/")}
           EOS
         else
           <<~EOS

Library/Homebrew/tap.rb

@@ -222,7 +222,7 @@ class Tap
 
   # Install this {Tap}.
   #
-  # @param [Hash] options
+  # @param  options [Hash]
   # @option options [String] :clone_target If passed, it will be used as the clone remote.
   # @option options [Boolean, nil] :force_auto_update If present, whether to override the
   #   logic that skips non-GitHub repositories during auto-updates.