[DOCS] Document :allow_nil option of #validate_uniqueness_of. Closes #3143 [Caio Chassot]

git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@5853 5ecf4fe2-1ee6-0310-87b1-e25e094e27de

activerecord/CHANGELOG

 *SVN*
 
+* [DOCS] Document :allow_nil option of #validate_uniqueness_of. Closes #3143 [Caio Chassot]
+
 * Bring the sybase adapter up to scratch for 1.2 release. [jsheets]
 
 * Rollback #new_record? and #id values for created records that rollback in an after_save callback. Closes #6910 [Ben Curren]

activerecord/lib/active_record/validations.rb

@@ -520,6 +520,7 @@ def validates_length_of(*attrs)
       # * <tt>message</tt> - Specifies a custom error message (default is: "has already been taken")
       # * <tt>scope</tt> - One or more columns by which to limit the scope of the uniquness constraint.
       # * <tt>case_sensitive</tt> - Looks for an exact match.  Ignored by non-text columns (true by default).
+      # * <tt>allow_nil</tt> - If set to true, skips this validation if the attribute is null (default is: false)
       # * <tt>if</tt> - Specifies a method, proc or string to call to determine if the validation should
       # occur (e.g. :if => :allow_validation, or :if => Proc.new { |user| user.signup_step > 2 }).  The
       # method, proc or string should return or evaluate to a true or false value.