[Python-checkins] cpython (merge 3.5 -> 3.6): Issue #29371: merge with 3.5
mariatta.wijaya
python-checkins at python.org
Mon Feb 6 23:19:03 EST 2017
https://hg.python.org/cpython/rev/c3d779f96b20
changeset: 106457:c3d779f96b20
branch: 3.6
parent: 106454:4463e311f5bd
parent: 106456:df62e833eeb1
user: Mariatta Wijaya <mariatta.wijaya at gmail.com>
date: Mon Feb 06 20:16:58 2017 -0800
summary:
Issue #29371: merge with 3.5
files:
Doc/library/doctest.rst | 24 +++++++++++++-----------
1 files changed, 13 insertions(+), 11 deletions(-)
diff --git a/Doc/library/doctest.rst b/Doc/library/doctest.rst
--- a/Doc/library/doctest.rst
+++ b/Doc/library/doctest.rst
@@ -510,9 +510,9 @@
A number of option flags control various aspects of doctest's behavior.
Symbolic names for the flags are supplied as module constants, which can be
-or'ed together and passed to various functions. The names can also be used in
-:ref:`doctest directives <doctest-directives>`, and may be passed to the
-doctest command line interface via the ``-o`` option.
+:ref:`bitwise ORed <bitwise>` together and passed to various functions.
+The names can also be used in :ref:`doctest directives <doctest-directives>`,
+and may be passed to the doctest command line interface via the ``-o`` option.
.. versionadded:: 3.4
The ``-o`` command line option.
@@ -877,8 +877,9 @@
nothing at the end. In verbose mode, the summary is detailed, else the summary
is very brief (in fact, empty if all tests passed).
- Optional argument *optionflags* (default value 0) takes the bitwise-or of
- option flags. See section :ref:`doctest-options`.
+ Optional argument *optionflags* (default value 0) takes the
+ :ref:`bitwise OR <bitwise>` of option flags.
+ See section :ref:`doctest-options`.
Optional argument *raise_on_error* defaults to false. If true, an exception is
raised upon the first failure or unexpected exception in an example. This
@@ -1098,18 +1099,19 @@
Set the :mod:`doctest` reporting flags to use.
- Argument *flags* takes the bitwise-or of option flags. See section
- :ref:`doctest-options`. Only "reporting flags" can be used.
+ Argument *flags* takes the :ref:`bitwise OR <bitwise>` of option flags. See
+ section :ref:`doctest-options`. Only "reporting flags" can be used.
This is a module-global setting, and affects all future doctests run by module
:mod:`unittest`: the :meth:`runTest` method of :class:`DocTestCase` looks at
the option flags specified for the test case when the :class:`DocTestCase`
instance was constructed. If no reporting flags were specified (which is the
typical and expected case), :mod:`doctest`'s :mod:`unittest` reporting flags are
- or'ed into the option flags, and the option flags so augmented are passed to the
- :class:`DocTestRunner` instance created to run the doctest. If any reporting
- flags were specified when the :class:`DocTestCase` instance was constructed,
- :mod:`doctest`'s :mod:`unittest` reporting flags are ignored.
+ :ref:`bitwise ORed <bitwise>` into the option flags, and the option flags
+ so augmented are passed to the :class:`DocTestRunner` instance created to
+ run the doctest. If any reporting flags were specified when the
+ :class:`DocTestCase` instance was constructed, :mod:`doctest`'s
+ :mod:`unittest` reporting flags are ignored.
The value of the :mod:`unittest` reporting flags in effect before the function
was called is returned by the function.
--
Repository URL: https://hg.python.org/cpython
More information about the Python-checkins
mailing list