From 7e022c552fa1204f118ab56d3c0cbc68b158fafb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9s=20Delfino?= Date: Mon, 25 Jun 2018 03:06:10 -0300 Subject: [PATCH] [2.7] bpo-33943: Add references in the docs for logging.basicConfig (GH-7858) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds references to info about file modes, `time.strftime()`, string formatting syntaxes, and logging levels.. (cherry picked from commit a8ddf85a84364d2c660e6670a7e06621993d1fdc) Co-authored-by: Andrés Delfino --- Doc/library/logging.rst | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index 0f568aaa97604b..09cae18cfde445 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -949,26 +949,26 @@ functions. +--------------+---------------------------------------------+ | Format | Description | +==============+=============================================+ - | ``filename`` | Specifies that a FileHandler be created, | + | *filename* | Specifies that a FileHandler be created, | | | using the specified filename, rather than a | | | StreamHandler. | +--------------+---------------------------------------------+ - | ``filemode`` | Specifies the mode to open the file, if | - | | filename is specified (if filemode is | - | | unspecified, it defaults to 'a'). | + | *filemode* | If *filename* is specified, open the file | + | | in this mode. Defaults to ``'a'``. | +--------------+---------------------------------------------+ - | ``format`` | Use the specified format string for the | + | *format* | Use the specified format string for the | | | handler. | +--------------+---------------------------------------------+ - | ``datefmt`` | Use the specified date/time format. | + | *datefmt* | Use the specified date/time format, as | + | | accepted by :func:`time.strftime`. | +--------------+---------------------------------------------+ - | ``level`` | Set the root logger level to the specified | - | | level. | + | *level* | Set the root logger level to the specified | + | | :ref:`level `. | +--------------+---------------------------------------------+ - | ``stream`` | Use the specified stream to initialize the | + | *stream* | Use the specified stream to initialize the | | | StreamHandler. Note that this argument is | - | | incompatible with 'filename' - if both are | - | | present, 'stream' is ignored. | + | | incompatible with *filename* - if both are | + | | present, *stream* is ignored. | +--------------+---------------------------------------------+