Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

[1.7.x] Fixed #22029 -- Removed obsolete advice on registering migrat…

…e/syncdb signal handlers.

All signals should now be registered in AppConfig.ready().

Thanks un33k for the report.

Backport of 5233b36 from master
  • Loading branch information...
commit 994274ea8315282484bc24aa403b2fd12b5bdeec 1 parent 4bd7411
@timgraham timgraham authored
Showing with 6 additions and 24 deletions.
  1. +6 −24 docs/ref/signals.txt
View
30 docs/ref/signals.txt
@@ -379,11 +379,6 @@ pre_migrate
Sent by the :djadmin:`migrate` command before it starts to install an
application. It's not emitted for applications that lack a ``models`` module.
-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:`migrate`.
-
Arguments sent with this signal:
``sender``
@@ -424,11 +419,6 @@ pre_syncdb
Sent by the :djadmin:`syncdb` command before it starts to install an
application.
-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`.
-
Arguments sent with this signal:
``sender``
@@ -472,13 +462,9 @@ Sent by the :djadmin:`migrate` command after it installs an application, and the
:djadmin:`flush` command. It's not emitted for applications that lack a
``models`` module.
-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:`migrate`. 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:`migrate` command.
+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:`migrate` command.
Arguments sent with this signal:
@@ -532,13 +518,9 @@ post_syncdb
Sent by the :djadmin:`syncdb` command after it installs an application, and the
: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`. 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.
+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:
Please sign in to comment.
Something went wrong with that request. Please try again.