From 6bd7d30e75ee28ac0038bde4ffff8c37533ecf0a Mon Sep 17 00:00:00 2001 From: Marcel Molina Date: Wed, 5 Dec 2007 15:06:45 +0000 Subject: Document options for update_counters. Closes #8091 [fearoffish] git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@8289 5ecf4fe2-1ee6-0310-87b1-e25e094e27de --- activerecord/CHANGELOG | 2 ++ activerecord/lib/active_record/base.rb | 12 ++++++++++++ 2 files changed, 14 insertions(+) (limited to 'activerecord') diff --git a/activerecord/CHANGELOG b/activerecord/CHANGELOG index 14ce50536e..54001561fb 100644 --- a/activerecord/CHANGELOG +++ b/activerecord/CHANGELOG @@ -1,5 +1,7 @@ *SVN* +* Document options for update_counters. Closes #8091 [fearoffish] + * Add documentation about the virtual attribute added by validates_confirmation_of and its behavior. Closes #8815 [JEG2, matt, kampers] * Add documentation for freeze and readonly related methods. Closes #8878 [pelargir, jeremymcanally] diff --git a/activerecord/lib/active_record/base.rb b/activerecord/lib/active_record/base.rb index 616b164b13..dad0573d88 100755 --- a/activerecord/lib/active_record/base.rb +++ b/activerecord/lib/active_record/base.rb @@ -574,7 +574,19 @@ module ActiveRecord #:nodoc: # with the given ID, altering the given hash of counters by the amount # given by the corresponding value: # + # ==== Options + # + # +id+ The id of the object you wish to update a counter on + # +counters+ An Array of Hashes containing the names of the fields + # to update as keys and the amount to update the field by as + # values + # + # ==== Examples + # + # # For the Post with id of 5, decrement the comment_count by 1, and + # # increment the action_count by 1 # Post.update_counters 5, :comment_count => -1, :action_count => 1 + # # Executes the following SQL: # # UPDATE posts # # SET comment_count = comment_count - 1, # # action_count = action_count + 1 -- cgit v1.2.3