Author: ubernostrum
Date: 2008-08-31 04:03:18 -0500 (Sun, 31 Aug 2008)
New Revision: 8755
Modified:
django/trunk/docs/ref/models/instances.txt
Log:
Fixed #8658: Added cross-references to signals docs from Model.save() docs
Modified: django/trunk/docs/ref/models/instances.txt
===================================================================
--- django/trunk/docs/ref/models/instances.txt 2008-08-31 08:55:08 UTC (rev
8754)
+++ django/trunk/docs/ref/models/instances.txt 2008-08-31 09:03:18 UTC (rev
8755)
@@ -107,10 +107,10 @@
When you save an object, Django performs the following steps:
- 1. **Emit a ``pre_save`` signal.** This provides a notification that
- an object is about to be saved. You can register a listener that
- will be invoked whenever this signal is emitted. (These signals are
- not yet documented.)
+ 1. **Emit a pre-save signal.** The :ref:`signal <ref-signals>`
+ :attr:`django.db.models.signals.pre_save` is sent, allowing any
+ functions listening for that signal to take some customized
+ action.
2. **Pre-process the data.** Each field on the object is asked to
perform any automated data modification that the field may need
@@ -140,9 +140,10 @@
data is then composed into an SQL statement for insertion into the
database.
- 5. **Emit a ``post_save`` signal.** As with the ``pre_save`` signal, this
- is used to provide notification that an object has been successfully
- saved. (These signals are not yet documented.)
+ 5. **Emit a post-save signal.** The signal
+ :attr:`django.db.models.signals.post_save` is sent, allowing
+ any functions listening for that signal to take some customized
+ action.
How Django knows to UPDATE vs. INSERT
-------------------------------------
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---
