Ticket #4837: form_options_helper_doc_patch.txt

Index: D:/User/Code/ruby/actionpack/lib/action_view/helpers/form_options_helper.rb
===================================================================
--- D:/User/Code/ruby/actionpack/lib/action_view/helpers/form_options_helper.rb (revision 3425)
+++ D:/User/Code/ruby/actionpack/lib/action_view/helpers/form_options_helper.rb (working copy)
@@ -67,6 +67,12 @@
       end
 
       # Return select and option tags for the given object and method using options_from_collection_for_select to generate the list of option tags.
+      #
+      # Want to display and update habtm relations with multiple selection?  Modify the following example:
+      #
+      # collection_select(:user, :group_ids, Group.find(:all), :id, :name,{},{:multiple=>'',:name=>'user[group_ids][]'})
+      #
+      # this works where users and groups are in a habtm relation
       def collection_select(object, method, collection, value_method, text_method, options = {}, html_options = {})
         InstanceTag.new(object, method, self, nil, options.delete(:object)).to_collection_select_tag(collection, value_method, text_method, options, html_options)
       end