diff --git a/docs/ref/contrib/comments/signals.txt b/docs/ref/contrib/comments/signals.txt index d3fd85cad5..cd406b56dd 100644 --- a/docs/ref/contrib/comments/signals.txt +++ b/docs/ref/contrib/comments/signals.txt @@ -16,6 +16,7 @@ comment_will_be_posted ====================== .. data:: django.contrib.comments.signals.comment_will_be_posted + :module: Sent just before a comment will be saved, after it's been sanity checked and submitted. This can be used to modify the comment (in place) with posting @@ -44,7 +45,8 @@ comment_was_posted ================== .. data:: django.contrib.comments.signals.comment_was_posted - + :module: + Sent just after the comment is saved. Arguments sent with this signal: @@ -63,6 +65,9 @@ Arguments sent with this signal: comment_was_flagged =================== +.. data:: django.contrib.comments.signals.comment_was_flagged + :module: + Sent after a comment was "flagged" in some way. Check the flag to see if this was a user requesting removal of a comment, a moderator approving/removing a comment, or some other custom user flag. diff --git a/docs/ref/signals.txt b/docs/ref/signals.txt index df6097fb82..a442f2cbc7 100644 --- a/docs/ref/signals.txt +++ b/docs/ref/signals.txt @@ -33,7 +33,10 @@ module system. pre_init -------- -.. data:: django.db.models.signals.pre_init +.. attribute:: django.db.models.signals.pre_init + :module: + +.. ^^^^^^^ this :module: hack keeps Sphinx from prepending the module. Whenever you instantiate a Django model,, this signal is sent at the beginning of the model's :meth:`~django.db.models.Model.__init__` method. @@ -74,6 +77,7 @@ post_init --------- .. data:: django.db.models.signals.post_init + :module: Like pre_init, but this one is sent when the :meth:`~django.db.models.Model.__init__`: method finishes. @@ -89,7 +93,8 @@ pre_save -------- .. data:: django.db.models.signals.pre_save - + :module: + This is sent at the beginning of a model's :meth:`~django.db.models.Model.save` method. @@ -105,7 +110,8 @@ post_save --------- .. data:: django.db.models.signals.post_save - + :module: + Like :data:`pre_save`, but sent at the end of the :meth:`~django.db.models.Model.save` method. @@ -124,7 +130,8 @@ pre_delete ---------- .. data:: django.db.models.signals.pre_delete - + :module: + Sent at the beginning of a model's :meth:`~django.db.models.Model.delete` method. @@ -140,7 +147,8 @@ post_delete ----------- .. data:: django.db.models.signals.post_delete - + :module: + Like :data:`pre_delete`, but sent at the end of the :meth:`~django.db.models.Model.delete` method. @@ -159,7 +167,8 @@ class_prepared -------------- .. data:: django.db.models.signals.class_prepared - + :module: + Sent whenever a model class has been "prepared" -- that is, once model has been defined and registered with Django's model system. Django uses this signal internally; it's not generally used in third-party applications. @@ -178,6 +187,7 @@ post_syncdb ----------- .. data:: django.db.models.signals.post_syncdb + :module: Sent by :djadmin:`syncdb` after it installs an application. @@ -227,7 +237,8 @@ request_started --------------- .. data:: django.core.signals.request_started - + :module: + Sent when Django begins processing an HTTP request. Arguments sent with this signal: @@ -242,7 +253,8 @@ request_finished ---------------- .. data:: django.core.signals.request_finished - + :module: + Sent when Django finishes processing an HTTP request. Arguments sent with this signal: @@ -254,7 +266,8 @@ got_request_exception --------------------- .. data:: django.core.signals.got_request_exception - + :module: + This signal is sent whenever Django encounters an exception while processing an incoming HTTP request. Arguments sent with this signal: @@ -277,7 +290,8 @@ template_rendered ----------------- .. data:: django.test.signals.template_rendered - + :module: + Sent when the test system renders a template. This signal is not emitted during normal operation of a Django server -- it is only available during testing.