Ticket #8884: doc_ar_reflection.2.diff

activerecord/lib/active_record/reflection.rb

@@ -76 +76 @@
-        @macro, @name, @options, @active_record = macro, name, options, active_record
-      end
-
-, so it would return :balance for "composed_of :balance, :class_name => 'Money'" or
-:clients for "has_many :clients"
+.  For example, <tt>composed_of :balance, :class_name => 'Money'</tt> will return
++:balance+ or for <tt>has_many :clients</tt> it will return +:clients+
-      def name
-        @name
-      end
-
-name of the macro, so it would return :composed_of for
-"composed_of :balance, :class_name => 'Money'" or :has_many for "has_many :clients"
+macro type. For example, <tt>composed_of :balance, :class_name => 'Money'</tt> will return +:composed_of+
+or for <tt>has_many :clients</tt> will return +:has_many+
-      def macro
-        @macro
-      end
-
-, so it would return { :class_name => "Money" }
-"composed_of :balance, :class_name => 'Money'" or {} for "has_many :clients"
+.  For example, it would return <tt>{ :class_name => "Money" }</tt>
+<tt>composed_of :balance, :class_name => 'Money'</tt> or +{}+ for <tt>has_many :clients</tt>
-      def options
-        @options
-      end
-
-, so "composed_of :balance, :class_name => 'Money'" returns the Money class and
-"has_many :clients" returns the Client
+.  For example, <tt>composed_of :balance, :class_name => 'Money'</tt> returns the +Money+
+class and <tt>has_many :clients</tt> returns the +Client+
-      def klass
-        @klass ||= class_name.constantize
-      end
-
+      # Returns the class name for the macro.  For example, <tt>composed_of :balance, :class_name => 'Money'</tt> returns +Money+
+      # and <tt>has_many :clients</tt> returns +Client+.
-      def class_name
-        @class_name ||= options[:class_name] || derive_class_name
-      end
-
+      # Returns +true+ if +self+ and +other_aggregation+ have the same +name+ attribute, +active_record+ attribute,
+      # and +other_aggregation+ has an options hash assigned to it.
-      def ==(other_aggregation)
-        name == other_aggregation.name && other_aggregation.options && active_record == other_aggregation.active_record
-      end