mirror of https://github.com/python/cpython
Issue #19795: Mark up True and False as literal text instead of bold.
This commit is contained in:
commit
0bbf8c08ab
|
@ -464,7 +464,7 @@ ancestor loggers. Because of this, it is unnecessary to define and configure
|
|||
handlers for all the loggers an application uses. It is sufficient to
|
||||
configure handlers for a top-level logger and create child loggers as needed.
|
||||
(You can, however, turn off propagation by setting the *propagate*
|
||||
attribute of a logger to *False*.)
|
||||
attribute of a logger to ``False``.)
|
||||
|
||||
|
||||
.. _handler-basic:
|
||||
|
@ -747,10 +747,10 @@ circumstances is dependent on the Python version.
|
|||
|
||||
For versions of Python prior to 3.2, the behaviour is as follows:
|
||||
|
||||
* If *logging.raiseExceptions* is *False* (production mode), the event is
|
||||
* If *logging.raiseExceptions* is ``False`` (production mode), the event is
|
||||
silently dropped.
|
||||
|
||||
* If *logging.raiseExceptions* is *True* (development mode), a message
|
||||
* If *logging.raiseExceptions* is ``True`` (development mode), a message
|
||||
'No handlers could be found for logger X.Y.Z' is printed once.
|
||||
|
||||
In Python 3.2 and later, the behaviour is as follows:
|
||||
|
|
|
@ -296,7 +296,7 @@ is the module's name in the Python package namespace.
|
|||
|
||||
Finds the caller's source filename and line number. Returns the filename, line
|
||||
number, function name and stack information as a 4-element tuple. The stack
|
||||
information is returned as ``None`` unless *stack_info* is *True*.
|
||||
information is returned as ``None`` unless *stack_info* is ``True``.
|
||||
|
||||
|
||||
.. method:: Logger.handle(record)
|
||||
|
|
|
@ -31,7 +31,7 @@ lots of shared sub-objects. The keys are ordinary strings.
|
|||
Because of Python semantics, a shelf cannot know when a mutable
|
||||
persistent-dictionary entry is modified. By default modified objects are
|
||||
written *only* when assigned to the shelf (see :ref:`shelve-example`). If the
|
||||
optional *writeback* parameter is set to *True*, all entries accessed are also
|
||||
optional *writeback* parameter is set to ``True``, all entries accessed are also
|
||||
cached in memory, and written back on :meth:`~Shelf.sync` and
|
||||
:meth:`~Shelf.close`; this can make it handier to mutate mutable entries in
|
||||
the persistent dictionary, but, if many entries are accessed, it can consume
|
||||
|
|
|
@ -361,8 +361,8 @@ functions.
|
|||
manner described in :ref:`converting-argument-sequence`. This is because
|
||||
the underlying ``CreateProcess()`` operates on strings.
|
||||
|
||||
The *shell* argument (which defaults to *False*) specifies whether to use
|
||||
the shell as the program to execute. If *shell* is *True*, it is
|
||||
The *shell* argument (which defaults to ``False``) specifies whether to use
|
||||
the shell as the program to execute. If *shell* is ``True``, it is
|
||||
recommended to pass *args* as a string rather than as a sequence.
|
||||
|
||||
On POSIX with ``shell=True``, the shell defaults to :file:`/bin/sh`. If
|
||||
|
|
|
@ -553,7 +553,7 @@ task isn't already covered by the URL parsing functions above.
|
|||
When a sequence of two-element tuples is used as the *query*
|
||||
argument, the first element of each tuple is a key and the second is a
|
||||
value. The value element in itself can be a sequence and in that case, if
|
||||
the optional parameter *doseq* is evaluates to *True*, individual
|
||||
the optional parameter *doseq* is evaluates to ``True``, individual
|
||||
``key=value`` pairs separated by ``'&'`` are generated for each element of
|
||||
the value sequence for the key. The order of parameters in the encoded
|
||||
string will match the order of parameter tuples in the sequence.
|
||||
|
|
|
@ -928,7 +928,7 @@ ElementTree Objects
|
|||
*method* is either ``"xml"``, ``"html"`` or ``"text"`` (default is
|
||||
``"xml"``).
|
||||
The keyword-only *short_empty_elements* parameter controls the formatting
|
||||
of elements that contain no content. If *True* (the default), they are
|
||||
of elements that contain no content. If ``True`` (the default), they are
|
||||
emitted as a single self-closed tag, otherwise they are emitted as a pair
|
||||
of start/end tags.
|
||||
|
||||
|
|
|
@ -63,8 +63,8 @@ or as base classes.
|
|||
should be a file-like object which will default to *sys.stdout*. *encoding* is
|
||||
the encoding of the output stream which defaults to ``'iso-8859-1'``.
|
||||
*short_empty_elements* controls the formatting of elements that contain no
|
||||
content: if *False* (the default) they are emitted as a pair of start/end
|
||||
tags, if set to *True* they are emitted as a single self-closed tag.
|
||||
content: if ``False`` (the default) they are emitted as a pair of start/end
|
||||
tags, if set to ``True`` they are emitted as a single self-closed tag.
|
||||
|
||||
.. versionadded:: 3.2
|
||||
The *short_empty_elements* parameter.
|
||||
|
|
|
@ -548,5 +548,5 @@ that may require changes to your code:
|
|||
|
||||
* The automatic name remapping in the pickle module for protocol 2 or lower can
|
||||
make Python 3.1 pickles unreadable in Python 3.0. One solution is to use
|
||||
protocol 3. Another solution is to set the *fix_imports* option to **False**.
|
||||
protocol 3. Another solution is to set the *fix_imports* option to *``False``*.
|
||||
See the discussion above for more details.
|
||||
|
|
|
@ -1001,13 +1001,13 @@ datetime and time
|
|||
after 1900. The new supported year range is from 1000 to 9999 inclusive.
|
||||
|
||||
* Whenever a two-digit year is used in a time tuple, the interpretation has been
|
||||
governed by :attr:`time.accept2dyear`. The default is *True* which means that
|
||||
governed by :attr:`time.accept2dyear`. The default is ``True`` which means that
|
||||
for a two-digit year, the century is guessed according to the POSIX rules
|
||||
governing the ``%y`` strptime format.
|
||||
|
||||
Starting with Py3.2, use of the century guessing heuristic will emit a
|
||||
:exc:`DeprecationWarning`. Instead, it is recommended that
|
||||
:attr:`time.accept2dyear` be set to *False* so that large date ranges
|
||||
:attr:`time.accept2dyear` be set to ``False`` so that large date ranges
|
||||
can be used without guesswork::
|
||||
|
||||
>>> import time, warnings
|
||||
|
@ -1043,7 +1043,7 @@ The :mod:`math` module has been updated with six new functions inspired by the
|
|||
C99 standard.
|
||||
|
||||
The :func:`~math.isfinite` function provides a reliable and fast way to detect
|
||||
special values. It returns *True* for regular numbers and *False* for *Nan* or
|
||||
special values. It returns ``True`` for regular numbers and ``False`` for *Nan* or
|
||||
*Infinity*:
|
||||
|
||||
>>> from math import isfinite
|
||||
|
@ -1193,7 +1193,7 @@ exception or silently drop the event depending on the value of
|
|||
|
||||
The use of filters has been simplified. Instead of creating a
|
||||
:class:`~logging.Filter` object, the predicate can be any Python callable that
|
||||
returns *True* or *False*.
|
||||
returns ``True`` or ``False``.
|
||||
|
||||
There were a number of other improvements that add flexibility and simplify
|
||||
configuration. See the module documentation for a full listing of changes in
|
||||
|
|
Loading…
Reference in New Issue