Changeset 7873

Timestamp:

10/14/07 05:32:57 (1 year ago)

Author:

rick

Message:

Add notes to documentation regarding attr_readonly behavior with counter caches and polymorphic associations. Closes #9835 [saimonmoore, rick]

Files:

• trunk/activerecord/CHANGELOG (modified) (1 diff)
• trunk/activerecord/lib/active_record/associations.rb (modified) (1 diff)

trunk/activerecord/CHANGELOG

@@ -1 +1 @@
-*SVN*
+
+* Add notes to documentation regarding attr_readonly behavior with counter caches and polymorphic associations.  Closes #9835 [saimonmoore, rick]
-
-* Observers can observe model names as symbols properly now.  Closes #9869  [queso]

trunk/activerecord/lib/active_record/associations.rb

@@ -776 +776 @@
-      #   is used on the associate class (such as a +Post+ class). You can also specify a custom counter cache column by providing 
-      #   a column name instead of a +true+/+false+ value to this option (e.g., <tt>:counter_cache => :my_custom_counter</tt>.)
+      #   Note: Specifying a counter_cache will add it to that model's list of readonly attributes using #attr_readonly.
-      # * <tt>:include</tt>  - specify second-order associations that should be eager loaded when this object is loaded.
-      # * <tt>:polymorphic</tt> - specify this association is a polymorphic association by passing +true+.
+      #   Note: If you've enabled the counter cache, then you may want to add the counter cache attribute 
+      #   to the attr_readonly list in the associated classes (e.g. class Post; attr_readonly :comments_count; end).
-      #
-      # Option examples: