summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorVinay Sajip <vinay_sajip@yahoo.co.uk>2013-03-08 23:22:22 (GMT)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>2013-03-08 23:22:22 (GMT)
commita7b584b68c1dbb82d4e5b1981b32523a0b52deca (patch)
treeab923332596f17dfa676d4d461c6aa004d3dcbfc
parente754636a5edf872d15d463f32429ea4c5ffb19b7 (diff)
downloadcpython-a7b584b68c1dbb82d4e5b1981b32523a0b52deca.zip
cpython-a7b584b68c1dbb82d4e5b1981b32523a0b52deca.tar.gz
cpython-a7b584b68c1dbb82d4e5b1981b32523a0b52deca.tar.bz2
Issue #17376: Clarified documentation for TimedRotatingFileHandler weekday rotation.
-rw-r--r--Doc/library/logging.handlers.rst6
1 files changed, 5 insertions, 1 deletions
diff --git a/Doc/library/logging.handlers.rst b/Doc/library/logging.handlers.rst
index 3d05400..a771ca1 100644
--- 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