diff options
| author | Andrés Delfino <adelfino@gmail.com> | 2018-06-25 06:06:10 (GMT) |
|---|---|---|
| committer | Tal Einat <taleinat+github@gmail.com> | 2018-06-25 06:06:10 (GMT) |
| commit | a8ddf85a84364d2c660e6670a7e06621993d1fdc (patch) | |
| tree | 3183b4d73ee63248a5e56e8cb057c78d0fba19f0 /Doc | |
| parent | cf67d6a934b51b1f97e72945b596477b271f70b8 (diff) | |
| download | cpython-a8ddf85a84364d2c660e6670a7e06621993d1fdc.zip cpython-a8ddf85a84364d2c660e6670a7e06621993d1fdc.tar.gz cpython-a8ddf85a84364d2c660e6670a7e06621993d1fdc.tar.bz2 | |
bpo-33943: Add references in the docs for logging.basicConfig (GH-7858)
Adds references to info about file modes, `time.strftime()`, string formatting
syntaxes, and logging levels.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/functions.rst | 5 | ||||
| -rw-r--r-- | Doc/library/logging.rst | 41 |
2 files changed, 27 insertions, 19 deletions
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index 457e1c3..7b1b0ca 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -971,6 +971,11 @@ are always available. They are listed here in alphabetical order. encoding. (For reading and writing raw bytes use binary mode and leave *encoding* unspecified.) The available modes are: + .. _filemodes: + + .. index:: + pair: file; modes + ========= =============================================================== Character Meaning ========= =============================================================== diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index 90fe92b..438078d 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -1147,41 +1147,44 @@ 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 :ref:`mode <filemodes>`. 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`. | +--------------+---------------------------------------------+ - | ``style`` | If ``format`` is specified, use this style | - | | for the format string. One of '%', '{' or | - | | '$' for %-formatting, :meth:`str.format` or | - | | :class:`string.Template` respectively, and | - | | defaulting to '%' if not specified. | + | *style* | If *format* is specified, use this style | + | | for the format string. One of ``'%'``, | + | | ``'{'`` or ``'$'`` for :ref:`printf-style | + | | <old-string-formatting>`, | + | | :meth:`str.format` or | + | | :class:`string.Template` respectively. | + | | Defaults to ``'%'``. | +--------------+---------------------------------------------+ - | ``level`` | Set the root logger level to the specified | - | | level. | + | *level* | Set the root logger level to the specified | + | | :ref:`level <levels>`. | +--------------+---------------------------------------------+ - | ``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, a ``ValueError`` is raised. | + | | incompatible with *filename* - if both | + | | are present, a ``ValueError`` is raised. | +--------------+---------------------------------------------+ - | ``handlers`` | If specified, this should be an iterable of | + | *handlers* | If specified, this should be an iterable of | | | already created handlers to add to the root | | | logger. Any handlers which don't already | | | have a formatter set will be assigned the | | | default formatter created in this function. | | | Note that this argument is incompatible | - | | with 'filename' or 'stream' - if both are | - | | present, a ``ValueError`` is raised. | + | | with *filename* or *stream* - if both | + | | are present, a ``ValueError`` is raised. | +--------------+---------------------------------------------+ | ``force`` | If this keyword argument is specified as | | | true, any existing handlers attached to the | |