Issue #17376: Clarified documentation for TimedRotatingFileHandler weekday rotation.
authorVinay Sajip <vinay_sajip@yahoo.co.uk>
Fri, 8 Mar 2013 23:22:22 +0000 (23:22 +0000)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>
Fri, 8 Mar 2013 23:22:22 +0000 (23:22 +0000)
Doc/library/logging.handlers.rst

index 3d05400603dc40da8cf0abf26e9ee2ab7b938faf..a771ca1ce3fe869bcd9306753e717ff36b21fc7d 100644 (file)
@@ -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