diff --git a/activerecord/lib/active_record/base.rb b/activerecord/lib/active_record/base.rb
index 77565b805d..9941697f3a 100755
--- a/activerecord/lib/active_record/base.rb
+++ b/activerecord/lib/active_record/base.rb
@@ -446,11 +446,10 @@ module ActiveRecord #:nodoc:
# * :group: An attribute name by which the result should be grouped. Uses the GROUP BY SQL-clause.
# * :limit: An integer determining the limit on the number of rows that should be returned.
# * :offset: An integer determining the offset from where the rows should be fetched. So at 5, it would skip rows 0 through 4.
- # * :joins: An SQL fragment for additional joins like "LEFT JOIN comments ON comments.post_id = id" (Rarely needed).
- # Accepts named associations in the form of :include, which will perform an INNER JOIN on the associated table(s).
- # The records will be returned read-only since they will have attributes that do not correspond to the table's columns.
+ # * :joins: Either an SQL fragment for additional joins like "LEFT JOIN comments ON comments.post_id = id" (rarely needed)
+ # or named associations in the same form used for the :include option, which will perform an INNER JOIN on the associated table(s).
+ # If the value is a string, then the records will be returned read-only since they will have attributes that do not correspond to the table's columns.
# Pass :readonly => false to override.
- # See adding joins for associations under Associations.
# * :include: Names associations that should be loaded alongside using LEFT OUTER JOINs. The symbols named refer
# to already defined associations. See eager loading under Associations.
# * :select: By default, this is * as in SELECT * FROM, but can be changed if you, for example, want to do a join but not
diff --git a/activerecord/lib/active_record/calculations.rb b/activerecord/lib/active_record/calculations.rb
index 7a9377587f..e08520f15f 100644
--- a/activerecord/lib/active_record/calculations.rb
+++ b/activerecord/lib/active_record/calculations.rb
@@ -15,12 +15,10 @@ module ActiveRecord
# The third approach, count using options, accepts an option hash as the only parameter. The options are:
#
# * :conditions: An SQL fragment like "administrator = 1" or [ "user_name = ?", username ]. See conditions in the intro.
- # * :joins: Either an SQL fragment for additional joins like "LEFT JOIN comments ON comments.post_id = id". (Rarely needed).
- # or names associations in the same form used for the :include option.
+ # * :joins: Either an SQL fragment for additional joins like "LEFT JOIN comments ON comments.post_id = id" (rarely needed)
+ # or named associations in the same form used for the :include option, which will perform an INNER JOIN on the associated table(s).
# If the value is a string, then the records will be returned read-only since they will have attributes that do not correspond to the table's columns.
# Pass :readonly => false to override.
- # See adding joins for associations under Associations.
- #
# * :include: Named associations that should be loaded alongside using LEFT OUTER JOINs. The symbols named refer
# to already defined associations. When using named associations, count returns the number of DISTINCT items for the model you're counting.
# See eager loading under Associations.