mirror of
https://github.com/python/cpython.git
synced 2025-08-03 16:39:00 +00:00
Fix a few doc errors, mostly undefined keywords.
This commit is contained in:
parent
6dc50f34dd
commit
375aec2315
14 changed files with 57 additions and 57 deletions
|
@ -6,7 +6,8 @@ Logging Cookbook
|
|||
|
||||
:Author: Vinay Sajip <vinay_sajip at red-dove dot com>
|
||||
|
||||
This page contains a number of recipes related to logging, which have been found useful in the past.
|
||||
This page contains a number of recipes related to logging, which have been found
|
||||
useful in the past.
|
||||
|
||||
.. currentmodule:: logging
|
||||
|
||||
|
@ -283,7 +284,7 @@ One solution is to use a two-part approach. For the first part, attach only a
|
|||
performance-critical threads. They simply write to their queue, which can be
|
||||
sized to a large enough capacity or initialized with no upper bound to their
|
||||
size. The write to the queue will typically be accepted quickly, though you
|
||||
will probably need to catch the :ref:`queue.Full` exception as a precaution
|
||||
will probably need to catch the :exc:`queue.Full` exception as a precaution
|
||||
in your code. If you are a library developer who has performance-critical
|
||||
threads in their code, be sure to document this (together with a suggestion to
|
||||
attach only ``QueueHandlers`` to your loggers) for the benefit of other
|
||||
|
|
|
@ -214,8 +214,8 @@ multiple modules, using the pattern in *mylib.py*. Note that for this simple
|
|||
usage pattern, you won't know, by looking in the log file, *where* in your
|
||||
application your messages came from, apart from looking at the event
|
||||
description. If you want to track the location of your messages, you'll need
|
||||
to refer to the documentation beyond the tutorial level - see
|
||||
:ref:`advanced-logging-tutorial`.
|
||||
to refer to the documentation beyond the tutorial level -- see
|
||||
:ref:`logging-advanced-tutorial`.
|
||||
|
||||
|
||||
Logging variable data
|
||||
|
@ -549,9 +549,9 @@ Programmers can configure logging in three ways:
|
|||
3. Creating a dictionary of configuration information and passing it
|
||||
to the :func:`dictConfig` function.
|
||||
|
||||
For the reference documentation on the last two options, see :ref:`config-ref`.
|
||||
The following example configures a very simple logger, a console handler, and
|
||||
a simple formatter using Python code::
|
||||
For the reference documentation on the last two options, see
|
||||
:ref:`logging-config-api`. The following example configures a very simple
|
||||
logger, a console handler, and a simple formatter using Python code::
|
||||
|
||||
import logging
|
||||
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue