kotovalexarian-likes-github/rails--rails
1
0
Fork 0
mirror of https://github.com/rails/rails.git synced 2022-11-09 12:12:34 -05:00
Code Releases Activity

Update the documentation for the :autosave option

Browse source 
I've noticed a caveat with the :autosave option biting people before.
Questions arise about why they must explicitly save an associated object
in their own before_save callbacks. I've updated the documentation as
such to note to users that the :autosave callback occurs before any
user defined callbacks. They must save the associated record themselves
if altering it in their own callbacks.

Signed-off-by: David Celis <david@davidcelis.com>
This commit is contained in:
David Celis 2012-08-23 07:44:43 -07:00
parent 891043d5d0
commit 230d7f7600
1 changed files with 3 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
activerecord/lib/active_record/associations.rb
View file

@ -1137,7 +1137,9 @@ module ActiveRecord
# [:autosave] # [:autosave]
# If true, always save the associated objects or destroy them if marked for destruction, # If true, always save the associated objects or destroy them if marked for destruction,
# when saving the parent object. If false, never save or destroy the associated objects. # when saving the parent object. If false, never save or destroy the associated objects.
# By default, only save associated objects that are new records. # By default, only save associated objects that are new records. This option is implemented as a
# before_save callback. Because callbacks are run in the order they are defined, associated objects
# may need to be explicitly saved in any user-defined before_save callbacks.
# #
# Note that <tt>accepts_nested_attributes_for</tt> sets <tt>:autosave</tt> to <tt>true</tt>. # Note that <tt>accepts_nested_attributes_for</tt> sets <tt>:autosave</tt> to <tt>true</tt>.
# [:inverse_of] # [:inverse_of]