Update 'ref/contrib/comments/moderation.txt' (#190)

sgryjp · sgryjp · commit 197141a96dc7 · 2014-12-29T11:22:46.000+09:00
1.0〜1.4間の更新差分を反映。
diff --git a/ref/contrib/comments/moderation.txt b/ref/contrib/comments/moderation.txt
@@ -1,10 +1,8 @@
-.. _ref-contrib-comments-moderation:
-
 ==========================
 Generic comment moderation
 ==========================
 
-:revision-up-to: 11321 (1.1) unfinished
+:revision-up-to: 17812 (1.4) unfinished
 
 .. module:: django.contrib.comments.moderation
    :synopsis: Support for automatic comment moderation.
@@ -33,7 +31,7 @@ and uses a two-step process to enable moderation for any given model:
    model class and the class which specifies its moderation options.
 
 A simple example is the best illustration of this. Suppose we have the
-following model, which would represent entries in a weblog::
+following model, which would represent entries in a Weblog::
 
     from django.db import models
     
@@ -108,7 +106,9 @@ Built-in moderation options
         If :attr:`auto_close_field` is used, this must specify the number
         of days past the value of the field specified by
         :attr:`auto_close_field` after which new comments for an object
-        should be disallowed. Default value is ``None``.
+        should be disallowed. Allowed values are ``None``, 0 (which disallows
+        comments immediately), or any positive integer. Default value is
+        ``None``.
 
     .. attribute:: email_notification
 
@@ -130,12 +130,18 @@ Built-in moderation options
         If :attr:`auto_moderate_field` is used, this must specify the number
         of days past the value of the field specified by
         :attr:`auto_moderate_field` after which new comments for an object
-        should be marked non-public. Default value is ``None``.
+        should be marked non-public. Allowed values are ``None``, 0 (which
+        moderates comments immediately), or any positive integer. Default
+        value is ``None``.
 
 Simply subclassing :class:`CommentModerator` and changing the values of these
 options will automatically enable the various moderation methods for any
 models registered using the subclass.
 
+.. versionchanged:: 1.3
+
+``moderate_after`` and ``close_after`` now accept 0 as a valid value.
+
 Adding custom moderation methods
 --------------------------------
 
