adds inline docs for dynamically created methods in Active Record

3 files changed, 35 insertions, 35 deletions

diff --git a/activerecord/lib/active_record/associations.rb b/activerecord/lib/active_record/associations.rb
index 5a60b13fd8..1984f8d6c5 100755
--- a/activerecord/lib/active_record/associations.rb
+++ b/activerecord/lib/active_record/associations.rb
@@ -1216,11 +1216,11 @@ module ActiveRecord
         # callbacks will be executed after the association is wiped out.
         old_method = "destroy_without_habtm_shim_for_#{reflection.name}"
         class_eval <<-end_eval unless method_defined?(old_method)
-          alias_method :#{old_method}, :destroy_without_callbacks
-          def destroy_without_callbacks
-            #{reflection.name}.clear
-            #{old_method}
-          end
+          alias_method :#{old_method}, :destroy_without_callbacks     # alias_method :destroy_without_habtm_shim_for_posts, :destroy_without_callbacks
+          def destroy_without_callbacks                               # def destroy_without_callbacks
+            #{reflection.name}.clear                                  #   posts.clear
+            #{old_method}                                             #   destroy_without_habtm_shim_for_posts
+          end                                                         # end
         end_eval
 
         add_association_callbacks(reflection.name, options)
diff --git a/activerecord/lib/active_record/connection_adapters/abstract/query_cache.rb b/activerecord/lib/active_record/connection_adapters/abstract/query_cache.rb
index 950bd72101..581c8898b1 100644
--- a/activerecord/lib/active_record/connection_adapters/abstract/query_cache.rb
+++ b/activerecord/lib/active_record/connection_adapters/abstract/query_cache.rb
@@ -14,12 +14,12 @@ module ActiveRecord
         def dirties_query_cache(base, *method_names)
           method_names.each do |method_name|
             base.class_eval <<-end_code, __FILE__, __LINE__
-              def #{method_name}_with_query_dirty(*args)
-                clear_query_cache if @query_cache_enabled
-                #{method_name}_without_query_dirty(*args)
-              end
-
-              alias_method_chain :#{method_name}, :query_dirty
+              def #{method_name}_with_query_dirty(*args)           # def update_with_query_dirty(*args)
+                clear_query_cache if @query_cache_enabled          #   clear_query_cache if @query_cache_enabled
+                #{method_name}_without_query_dirty(*args)          #   update_without_query_dirty(*args)
+              end                                                  # end
+                                                                   #
+              alias_method_chain :#{method_name}, :query_dirty     # alias_method_chain :update, :query_dirty
             end_code
           end
         end
diff --git a/activerecord/lib/active_record/connection_adapters/abstract/schema_definitions.rb b/activerecord/lib/active_record/connection_adapters/abstract/schema_definitions.rb
index fe9cbcf024..a65e8bf6ca 100644
--- a/activerecord/lib/active_record/connection_adapters/abstract/schema_definitions.rb
+++ b/activerecord/lib/active_record/connection_adapters/abstract/schema_definitions.rb
@@ -476,12 +476,12 @@ module ActiveRecord
 
       %w( string text integer float decimal datetime timestamp time date binary boolean ).each do |column_type|
         class_eval <<-EOV
-          def #{column_type}(*args)
-            options = args.extract_options!
-            column_names = args
-
-            column_names.each { |name| column(name, '#{column_type}', options) }
-          end
+          def #{column_type}(*args)                                                  # def string(*args)
+            options = args.extract_options!                                          #   options = args.extract_options!
+            column_names = args                                                      #   column_names = args
+                                                                                     #
+            column_names.each { |name| column(name, '#{column_type}', options) }     #   column_names.each { |name| column(name, 'string', options) }
+          end                                                                        # end
         EOV
       end
 
@@ -676,24 +676,24 @@ module ActiveRecord
       #  t.string(:goat, :sheep)
       %w( string text integer float decimal datetime timestamp time date binary boolean ).each do |column_type|
         class_eval <<-EOV
-          def #{column_type}(*args)
-            options = args.extract_options!
-            column_names = args
-
-            column_names.each do |name|
-              column = ColumnDefinition.new(@base, name, '#{column_type}')
-              if options[:limit]
-                column.limit = options[:limit]
-              elsif native['#{column_type}'.to_sym].is_a?(Hash)
-                column.limit = native['#{column_type}'.to_sym][:limit]
-              end
-              column.precision = options[:precision]
-              column.scale = options[:scale]
-              column.default = options[:default]
-              column.null = options[:null]
-              @base.add_column(@table_name, name, column.sql_type, options)
-            end
-          end
+          def #{column_type}(*args)                                             # def string(*args)
+            options = args.extract_options!                                     #   options = args.extract_options!
+            column_names = args                                                 #   column_names = args
+                                                                                #
+            column_names.each do |name|                                         #   column_names.each do |name|
+              column = ColumnDefinition.new(@base, name, '#{column_type}')      #     column = ColumnDefinition.new(@base, name, 'string')
+              if options[:limit]                                                #     if options[:limit]
+                column.limit = options[:limit]                                  #       column.limit = options[:limit]
+              elsif native['#{column_type}'.to_sym].is_a?(Hash)                 #     elsif native['string'.to_sym].is_a?(Hash)
+                column.limit = native['#{column_type}'.to_sym][:limit]          #       column.limit = native['string'.to_sym][:limit]
+              end                                                               #     end
+              column.precision = options[:precision]                            #     column.precision = options[:precision]
+              column.scale = options[:scale]                                    #     column.scale = options[:scale]
+              column.default = options[:default]                                #     column.default = options[:default]
+              column.null = options[:null]                                      #     column.null = options[:null]
+              @base.add_column(@table_name, name, column.sql_type, options)     #     @base.add_column(@table_name, name, column.sql_type, options)
+            end                                                                 #   end
+          end                                                                   # end
         EOV
       end