From 3cb0283fb6547982b35fda1e0d4af00071c026ae Mon Sep 17 00:00:00 2001
From: Mikel Lindsaar <raasdnil@gmail.com>
Date: Tue, 19 Jan 2010 11:29:01 +1100
Subject: [PATCH] Documentation cleanup and linkage for validator

---
 activemodel/README                        | 23 +++++++++++++++++++++++
 activemodel/lib/active_model/validator.rb |  5 +++--
 2 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/activemodel/README b/activemodel/README
index d2b51e2390..cf103b8d6d 100644
--- a/activemodel/README
+++ b/activemodel/README
@@ -193,3 +193,26 @@ functionality from the following modules:
 
   {Learn more}[link:classes/ActiveModel/Validations.html]
   
+* Make custom validators
+
+   class Person
+     include ActiveModel::Validations
+     validates_with HasNameValidator
+     attr_accessor :name
+   end
+   
+   class HasNameValidator < ActiveModel::Validator
+     def validate(record)
+      record.errors[:name] = "must exist" if record.name.blank?
+     end
+   end
+  
+   p = ValidatorPerson.new
+   p.valid?                  #=>  false
+   p.errors.full_messages    #=> ["Name must exist"]
+   p.name = "Bob"
+   p.valid?                  #=>  true
+
+  {Learn more}[link:classes/ActiveModel/Validator.html]
+  
+  
\ No newline at end of file
diff --git a/activemodel/lib/active_model/validator.rb b/activemodel/lib/active_model/validator.rb
index 382a4cc98d..ad9729de00 100644
--- a/activemodel/lib/active_model/validator.rb
+++ b/activemodel/lib/active_model/validator.rb
@@ -1,5 +1,6 @@
 module ActiveModel #:nodoc:
-  # A simple base class that can be used along with ActiveModel::Validations::ClassMethods.validates_with
+  # A simple base class that can be used along with 
+  # +ActiveModel::Validations::ClassMethods.validates_with+
   #
   #   class Person
   #     include ActiveModel::Validations
@@ -28,7 +29,7 @@ module ActiveModel #:nodoc:
   #   end
   #
   #   class MyValidator < ActiveModel::Validator
-  #     def validate
+  #     def validate(record)
   #       record # => The person instance being validated
   #       options # => Any non-standard options passed to validates_with
   #     end