summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorJames Bennett <ubernostrum@gmail.com>2008-08-31 09:03:18 +0000
committerJames Bennett <ubernostrum@gmail.com>2008-08-31 09:03:18 +0000
commitf2c80f93d96f0d35eba4297fd60a79eef6528738 (patch)
tree9b3fe84817351ebcb3cf2ba1e9c35c12aa28005a /docs/ref
parent6ba55eee30de948f46f39afda2638f7504d63dd9 (diff)
Fixed #8658: Added cross-references to signals docs from Model.save() docs
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8755 bcc190cf-cafb-0310-a4f2-bffc1f526a37
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/models/instances.txt15
1 files changed, 8 insertions, 7 deletions
diff --git a/docs/ref/models/instances.txt b/docs/ref/models/instances.txt
index 1085e7b6df..c315bec89b 100644
--- a/docs/ref/models/instances.txt
+++ b/docs/ref/models/instances.txt
@@ -107,10 +107,10 @@ What happens when you save?
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 @@ When you save an object, Django performs the following steps:
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
-------------------------------------