more documentation for update_attribute

activerecord/lib/active_record/persistence.rb

@@ -105,13 +105,14 @@ def becomes(klass)
     # Updates a single attribute and saves the record.  
     # This is especially useful for boolean flags on existing records. Also note that
     #
-    # * validation is skipped
+    # * The attribute being updated must be a column name.
+    # * Validation is skipped
     # * No callbacks are invoked 
     # * updated_at/updated_on column is updated if that column is available
-    # * does not work on associations
-    # * does not work on attr_accessor attributes. The attribute that is being updated must be column name.
-    # * does not work on new record. <tt>record.new_record?</tt> should return false for this method to work.
-    # * updates only the attribute that is input to the method. If there are other changed attributes then
+    # * Does not work on associations
+    # * Does not work on attr_accessor attributes. 
+    # * Does not work on new record. <tt>record.new_record?</tt> should return false for this method to work.
+    # * Updates only the attribute that is input to the method. If there are other changed attributes then
     #   those attributes are left alone. In that case even after this method has done its work <tt>record.changed?</tt>
     #   will return true.
     #