summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorPaul McMillan <Paul@McMillan.ws>2011-09-22 04:36:15 +0000
committerPaul McMillan <Paul@McMillan.ws>2011-09-22 04:36:15 +0000
commit4f9cf2ef2765af31c1fc2f195211f9335824824f (patch)
treebfc4667b0ac2daa914e0279dcb6aa4f31c2b964f /docs/ref
parent1d96d886e7f36fcee918b7fa5c32b677bed83b0d (diff)
Fixed #15633 -- Improved docs for post_syncdb signal.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16874 bcc190cf-cafb-0310-a4f2-bffc1f526a37
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/signals.txt8
1 files changed, 6 insertions, 2 deletions
diff --git a/docs/ref/signals.txt b/docs/ref/signals.txt
index 5f55bbe418..7924c6f305 100644
--- a/docs/ref/signals.txt
+++ b/docs/ref/signals.txt
@@ -365,12 +365,16 @@ post_syncdb
.. data:: django.db.models.signals.post_syncdb
:module:
-Sent by :djadmin:`syncdb` after it installs an application.
+Sent by :djadmin:`syncdb` command after it installs an application, and
+:djadmin:`flush` command.
Any handlers that listen to this signal need to be written in a particular
place: a ``management`` module in one of your :setting:`INSTALLED_APPS`. If
handlers are registered anywhere else they may not be loaded by
-:djadmin:`syncdb`.
+:djadmin:`syncdb`. It is important that handlers of this signal perform
+idempotent changes (e.g. no database alterations) as this may cause the
+:djadmin:`flush` management command to fail if it also ran during the
+:djadmin:`syncdb` command.
Arguments sent with this signal: