Issue #17376: Clarified documentation for TimedRotatingFileHandler weekday rotation.

vsajip · vsajip · commit 832d99bdbbf3 · 2013-03-08T23:24:30.000Z
diff --git a/Doc/library/logging.handlers.rst b/Doc/library/logging.handlers.rst
@@ -236,11 +236,15 @@ timed intervals.
    +----------------+-----------------------+
    | ``'D'``        | Days                  |
    +----------------+-----------------------+
-   | ``'W'``        | Week day (0=Monday)   |
+   | ``'W0'-'W6'``  | Weekday (0=Monday)    |
    +----------------+-----------------------+
    | ``'midnight'`` | Roll over at midnight |
    +----------------+-----------------------+
 
+   When using weekday-based rotation, specify 'W0' for Monday, 'W1' for
+   Tuesday, and so on up to 'W6' for Sunday. In this case, the value passed for
+   *interval* isn't used.
+
    The system will save old log files by appending extensions to the filename.
    The extensions are date-and-time based, using the strftime format
    ``%Y-%m-%d_%H-%M-%S`` or a leading portion thereof, depending on the
