From 96d3f152227b31e1ca2f0ac2814dda741dccaaea Mon Sep 17 00:00:00 2001
From: David Heinemeier Hansson <david@loudthinking.com>
Date: Thu, 17 Feb 2005 19:38:02 +0000
Subject: Documentation on :include_blank #579

git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@654 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
---
 actionpack/lib/action_view/helpers/form_options_helper.rb | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/actionpack/lib/action_view/helpers/form_options_helper.rb b/actionpack/lib/action_view/helpers/form_options_helper.rb
index aa448764da..2c321b8336 100644
--- a/actionpack/lib/action_view/helpers/form_options_helper.rb
+++ b/actionpack/lib/action_view/helpers/form_options_helper.rb
@@ -5,6 +5,19 @@ require File.dirname(__FILE__) + '/form_helper'
 module ActionView
   module Helpers
     # Provides a number of methods for turning different kinds of containers into a set of option tags.
+    # == Options
+    # The <tt>collection_select</tt>, <tt>country_select</tt>, and <tt>select</tt> methods take an <tt>options</tt> parameter, a hash.
+    #
+    # * <tt>:include_blank</tt> - set to true if the first option element of the select element is a blank. Useful if there is not a default value required for the select element.
+    #   select("post", "category", Post::CATEGORIES, {:include_blank => true})
+    #
+    # Could become:
+    #
+    #   <select name="post[category]">
+    #     <option></option>
+    #     <option>joke</option>
+    #     <option>poem</option>
+    #   </select>
     module FormOptionsHelper
       include ERB::Util
 
-- 
cgit v1.2.3