Fixed #15633 -- Improved docs for post_syncdb signal.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16874 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Paul McMillan 2011-09-22 04:36:15 +00:00
parent 1d96d886e7
commit 4f9cf2ef27
1 changed files with 6 additions and 2 deletions

View File

@ -365,12 +365,16 @@ post_syncdb
.. data:: django.db.models.signals.post_syncdb .. data:: django.db.models.signals.post_syncdb
:module: :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 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 place: a ``management`` module in one of your :setting:`INSTALLED_APPS`. If
handlers are registered anywhere else they may not be loaded by 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: Arguments sent with this signal: