From 4f9cf2ef2765af31c1fc2f195211f9335824824f Mon Sep 17 00:00:00 2001 From: Paul McMillan Date: Thu, 22 Sep 2011 04:36:15 +0000 Subject: [PATCH] Fixed #15633 -- Improved docs for post_syncdb signal. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16874 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/ref/signals.txt | 8 ++++++-- 1 file 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: