Fix and remove various TODOs.

Fix those that can be done so without tearing Homebrew to pieces and
remove the comments for those that can never be done.

Author: MikeMcQuaid

Library/Homebrew/brew.rb

@@ -23,8 +23,7 @@
 def require?(path)
   require path
 rescue LoadError => e
-  # HACK: ( because we should raise on syntax errors but
-  # not if the file doesn't exist. TODO make robust!
+  # we should raise on syntax errors but not if the file doesn't exist.
   raise unless e.to_s.include? path
 end
 

Library/Homebrew/dependable.rb

@@ -20,8 +20,6 @@ def run?
   end
 
   def required?
-    # FIXME: Should `required?` really imply `!build?`? And if so, why doesn't
-    #        any of `optional?` and `recommended?` equally imply `!build?`?
     !build? && !optional? && !recommended?
   end
 

Library/Homebrew/extend/ENV/std.rb

@@ -1,7 +1,6 @@
 require "hardware"
 require "extend/ENV/shared"
 
-# TODO: deprecate compiling related codes after it's only used by brew test.
 # @private
 module Stdenv
   include SharedEnvExtension

Library/Homebrew/extend/pathname.rb

@@ -331,7 +331,6 @@ def verify_checksum(expected)
     raise ChecksumMismatchError.new(self, expected, actual) unless expected == actual
   end
 
-  # FIXME: eliminate the places where we rely on this method
   alias to_str to_s unless method_defined?(:to_str)
 
   def cd

Library/Homebrew/formula.rb

@@ -1908,7 +1908,6 @@ def versioned_prefix(v)
   def exec_cmd(cmd, args, out, logfn)
     ENV["HOMEBREW_CC_LOG_PATH"] = logfn
 
-    # TODO: system "xcodebuild" is deprecated, this should be removed soon.
     ENV.remove_cc_etc if cmd.to_s.start_with? "xcodebuild"
 
     # Turn on argument filtering in the superenv compiler wrapper.

Library/Homebrew/formula_installer.rb

@@ -887,6 +887,6 @@ def unlock
   def puts_requirement_messages
     return unless @requirement_messages
     return if @requirement_messages.empty?
-    puts @requirement_messages
+    $stderr.puts @requirement_messages
   end
 end

Library/Homebrew/global.rb

@@ -62,7 +62,6 @@ def raise_deprecation_exceptions?
   end
 end.compact.freeze
 
-# TODO: remove this as soon as it's removed from commands.rb.
 HOMEBREW_INTERNAL_COMMAND_ALIASES = {
   "ls" => "list",
   "homepage" => "home",

Library/Homebrew/os/mac/xquartz.rb

@@ -5,7 +5,6 @@ module Mac
     module XQuartz
       module_function
 
-      # TODO: confirm this path when you have internet
       DEFAULT_BUNDLE_PATH = Pathname.new("Applications/Utilities/XQuartz.app").freeze
       FORGE_BUNDLE_ID = "org.macosforge.xquartz.X11".freeze
       APPLE_BUNDLE_ID = "org.x.X11".freeze

Library/Homebrew/test/cmd/install_spec.rb

@@ -217,10 +217,9 @@ class NonFatalRequirement < Requirement
       depends_on NonFatalRequirement
     EOS
 
-    # FIXME: This should output to STDERR.
     expect { brew "install", "testball1" }
-      .to output(/NonFatalRequirement unsatisfied!/).to_stdout
-      .and not_to_output.to_stderr
+      .to output(/NonFatalRequirement unsatisfied!/).to_stderr
+      .and output(/built in/).to_stdout
       .and be_a_success
   end
 
@@ -234,10 +233,9 @@ class FatalRequirement < Requirement
       depends_on FatalRequirement
     EOS
 
-    # FIXME: This should output to STDERR.
     expect { brew "install", "testball1" }
-      .to output(/FatalRequirement unsatisfied!/).to_stdout
-      .and output(/An unsatisfied requirement failed this build./).to_stderr
+      .to output(/FatalRequirement unsatisfied!/).to_stderr
+      .and not_to_output.to_stdout
       .and be_a_failure
   end
 end

Library/Homebrew/utils/analytics.sh

@@ -85,8 +85,6 @@ report-analytics-screenview-command() {
   fi
 
   # Don't report commands used mostly by our scripts and not users.
-  # TODO: list more e.g. shell completion things here perhaps using a single
-  # script as a shell-completion entry point.
   case "$HOMEBREW_COMMAND" in
     --prefix|analytics|command|commands)
       return