Explain the 3 states options[:user_install] can have.

This was issue previously, so hopefully this comment tries to state this
explicitly for future readers.

Author: voxik

lib/rubygems/installer.rb

@@ -680,6 +680,10 @@ def process_options # :nodoc:
     unless @gem_home
       # `--build-root` overrides `--user-install` and auto-user-install
       if @build_root.nil?
+        # Please note that `options[:user_install]` might have three states:
+        # * `true`: `--user-install`
+        # * `false`: `--no-user-install` and
+        # * `nil`: option was not specified
         if options[:user_install]
           @gem_home = Gem.user_dir
         elsif options[:user_install].nil? && !ENV.key?("GEM_HOME") && (File.exist?(Gem.dir) && !File.writable?(Gem.dir))