0
@@ -1,5 +1,9 @@
0
 module ActiveRecord
0
   module Associations
0
+    # This is the proxy that handles a has many association.
0
+    #
0
+    # If the association has a <tt>:through</tt> option further specialization
0
+    # is provided by its child HasManyThroughAssociation.
0
     class HasManyAssociation < AssociationCollection #:nodoc:
0
       # Count the number of associated records. All arguments are optional.
0
       def count(*args)
0
@@ -27,6 +31,16 @@ module ActiveRecord
0
           end
0
         end
0
 
0
+        # Returns the number of records in this collection.
0
+        #
0
+        # If the association has a counter cache it gets that value. Otherwise
0
+        # a count via SQL is performed, bounded to <tt>:limit</tt> if there's one.
0
+        # That does not depend on whether the collection has already been loaded
0
+        # or not. The +size+ method is the one that takes the loaded flag into
0
+        # account and delegates to +count_records+ if needed.
0
+        #
0
+        # If the collection is empty the target is set to an empty array and
0
+        # the loaded flag is set to true as well.
0
         def count_records
0
           count = if has_cached_counter?
0
             @owner.send(:read_attribute, cached_counter_attribute_name)