0
@@ -1,5 +1,7 @@
0
 *1.14.3* (June 27th, 2006)
0
 
0
+* Update callbacks documentation. #3970 [Robby Russell <robby@planetargon.com>]
0
+
0
 * Properly quote index names in migrations (closes #4764) [John Long]
0
 
0
 * Ensure that Associations#include_eager_conditions? checks both scoped and explicit conditions [Rick]

0
@@ -243,6 +243,10 @@ module ActiveRecord
0
     def before_save() end
0
 
0
     # Is called _after_ Base.save (regardless of whether it's a create or update save).
0
+    #
0
+    #  class Contact < ActiveRecord::Base
0
+    #    after_save { logger.info( 'New contact saved!' ) }
0
+    #  end
0
     def after_save()  end
0
     def create_or_update_with_callbacks #:nodoc:
0
       return false if callback(:before_save) == false
0
@@ -312,9 +316,16 @@ module ActiveRecord
0
     end
0
 
0
     # Is called _before_ Base.destroy.
0
+    #
0
+    # Note: If you need to _destroy_ or _nullify_ associated records first,
0
+    # use the _:dependent_ option on your associations.
0
     def before_destroy() end
0
 
0
     # Is called _after_ Base.destroy (and all the attributes have been frozen).
0
+    #
0
+    #  class Contact < ActiveRecord::Base
0
+    #    after_destroy { |record| logger.info( "Contact #{record.id} was destroyed." ) }
0
+    #  end
0
     def after_destroy()  end
0
     def destroy_with_callbacks #:nodoc:
0
       return false if callback(:before_destroy) == false