Browse Source

Issue #19795: Mark up True and False as literal text instead of bold.

pull/9921/head
Serhiy Storchaka 9 years ago
parent
commit
0bbf8c08ab
  1. 6
      Doc/howto/logging.rst
  2. 2
      Doc/library/logging.rst
  3. 2
      Doc/library/shelve.rst
  4. 4
      Doc/library/subprocess.rst
  5. 2
      Doc/library/urllib.parse.rst
  6. 2
      Doc/library/xml.etree.elementtree.rst
  7. 4
      Doc/library/xml.sax.utils.rst
  8. 2
      Doc/whatsnew/3.1.rst
  9. 8
      Doc/whatsnew/3.2.rst

6
Doc/howto/logging.rst

@ -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:

2
Doc/library/logging.rst

@ -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)

2
Doc/library/shelve.rst

@ -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

4
Doc/library/subprocess.rst

@ -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

2
Doc/library/urllib.parse.rst

@ -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.

2
Doc/library/xml.etree.elementtree.rst

@ -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.

4
Doc/library/xml.sax.utils.rst

@ -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.

2
Doc/whatsnew/3.1.rst

@ -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.

8
Doc/whatsnew/3.2.rst

@ -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…
Cancel
Save