0
@@ -2242,15 +2242,18 @@ module ActiveRecord #:nodoc:
0
         save!
0
       end
0
 
0
-      # Initializes the +attribute+ to zero if nil and adds the value passed as +by+ (default is one). Only makes sense for number-based attributes. Returns self.
0
+      # Initializes +attribute+ to zero if +nil+ and adds the value passed as +by+ (default is 1).
0
+      # The increment is performed directly on the underlying attribute, no setter is invoked.
0
+      # Only makes sense for number-based attributes. Returns +self+.
0
       def increment(attribute, by = 1)
0
         self[attribute] ||= 0
0
         self[attribute] += by
0
         self
0
       end
0
 
0
-      # Increments the +attribute+ and saves the record.
0
-      # Note: Updates made with this method aren't subjected to validation checks
0
+      # Increments +attribute+ via and saves the record. This method differs from
0
+      # its non-bang version in that it passes through the attribute setter.
0
+      # Saving is not subjected to validation checks. Returns +self+.
0
       def increment!(attribute, by = 1)
0
         increment(attribute, by).update_attribute(attribute, self[attribute])
0
       end