env

Library/Homebrew/exceptions.rb

@@ -565,7 +565,7 @@ def initialize(formulae)
   end
 end
 
-# Raised by {Homebrew.install}, {Homebrew.reinstall} and {Homebrew.upgrade}
+# Raised by `Homebrew.install`, `Homebrew.reinstall` and `Homebrew.upgrade`
 # if the user passes any flags/environment that would case a bottle-only
 # installation on a system without build tools to fail.
 class BuildFlagsError < RuntimeError

Library/Homebrew/extend/ENV.rb

@@ -17,11 +17,14 @@ def superenv?(env)
   private :superenv?
 end
 
-# `ENV` is not actually a class, but this makes YARD happy
-# @see https://rubydoc.info/stdlib/core/ENV `ENV` core documentation
-#
 # @!parse
-# class ENV; end
+#   # `ENV` is not actually a class, but this makes YARD happy
+#   # @see https://rubydoc.info/stdlib/core/ENV
+#   #   <code>ENV</code> core documentation
+#   # @see Superenv
+#   # @see Stdenv
+#   class ENV; end
+
 module EnvActivation
   sig { params(env: T.nilable(String)).void }
   def activate_extensions!(env: nil)
@@ -74,4 +77,5 @@ def clear_sensitive_environment!
   end
 end
 
+
 ENV.extend(EnvActivation)

Library/Homebrew/extend/ENV.rbi

@@ -1,5 +1,6 @@
 # typed: strict
 
+# @!visibility private
 module EnvMethods
   include Kernel
 
@@ -39,6 +40,7 @@ module EnvActivation
   include Superenv
 end
 
+# @!visibility private
 class Sorbet
   module Private
     module Static

Library/Homebrew/extend/ENV/shared.rbi

@@ -4,6 +4,7 @@ module SharedEnvExtension
   include EnvMethods
 end
 
+# @!visibility private
 class Sorbet
   module Private
     module Static