From f81d771f0657ae8375b84a77a059812cce5d6fd9 Mon Sep 17 00:00:00 2001
From: Jack Danger Canty <git@6brand.com>
Date: Tue, 6 May 2008 23:35:05 -0700
Subject: [PATCH] doc:
 ActiveRecord::Reflection::AssociationReflection#through_reflection

Added documentation demonstrating the use of #through_reflection for
finding intervening reflection objects for HasManyThrough
and HasOneThrough.
---
 activerecord/lib/active_record/reflection.rb | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/activerecord/lib/active_record/reflection.rb b/activerecord/lib/active_record/reflection.rb
index 61005af83f..811e53c428 100644
--- a/activerecord/lib/active_record/reflection.rb
+++ b/activerecord/lib/active_record/reflection.rb
@@ -153,6 +153,17 @@ module ActiveRecord
         end
       end
 
+      # Returns the AssociationReflection object specified in the <tt>:through</tt> option
+      # of a HasMantThrough or HasOneThrough association. Example:
+      #
+      #   class Post < ActiveRecord::Base
+      #     has_many :taggings
+      #     has_many :tags, :through => :taggings
+      #   end
+      #
+      #   tags_reflection = Post.reflect_on_association(:tags)
+      #   taggings_reflection = tags_reflection.through_reflection
+      #
       def through_reflection
         @through_reflection ||= options[:through] ? active_record.reflect_on_association(options[:through]) : false
       end