Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Fixed #15633 -- Improved docs for post_syncdb signal.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16874 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit 4f9cf2ef2765af31c1fc2f195211f9335824824f 1 parent 1d96d88
Paul McMillan authored September 22, 2011

Showing 1 changed file with 6 additions and 2 deletions. Show diff stats Hide diff stats

  1. 8  docs/ref/signals.txt
8  docs/ref/signals.txt
@@ -365,12 +365,16 @@ post_syncdb
365 365
 .. data:: django.db.models.signals.post_syncdb
366 366
    :module:
367 367
 
368  
-Sent by :djadmin:`syncdb` after it installs an application.
  368
+Sent by :djadmin:`syncdb` command after it installs an application, and
  369
+:djadmin:`flush` command.
369 370
 
370 371
 Any handlers that listen to this signal need to be written in a particular
371 372
 place: a ``management`` module in one of your :setting:`INSTALLED_APPS`. If
372 373
 handlers are registered anywhere else they may not be loaded by
373  
-:djadmin:`syncdb`.
  374
+:djadmin:`syncdb`. It is important that handlers of this signal perform
  375
+idempotent changes (e.g. no database alterations) as this may cause the
  376
+:djadmin:`flush` management command to fail if it also ran during the
  377
+:djadmin:`syncdb` command.
374 378
 
375 379
 Arguments sent with this signal:
376 380
 

0 notes on commit 4f9cf2e

Please sign in to comment.
Something went wrong with that request. Please try again.