Permalink
Browse files

[1.3.X] Fixed #15633 -- Improved docs for post_syncdb signal. Thanks …

…Justin Lilly for the patch.

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.3.X@16879 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 2a4aa8b commit 35e807c4a5fb5bb4d72ede54c92d7359a19c3370 @PaulMcMillan PaulMcMillan committed Sep 22, 2011
Showing with 6 additions and 2 deletions.
  1. +6 −2 docs/ref/signals.txt
View
8 docs/ref/signals.txt
@@ -352,12 +352,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
+idempodent 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:

0 comments on commit 35e807c

Please sign in to comment.