Incorporated feeback on doc for doctest_default_flags (#2471).

This commit is contained in:
taschini 2016-04-21 12:30:39 +02:00
parent 8c1d9cc71c
commit 604b45d44b

View File

@ -55,10 +55,10 @@ names.
.. rst:directive:: .. doctest:: [group] .. rst:directive:: .. doctest:: [group]
A doctest-style code block. You can use standard :mod:`doctest` A doctest-style code block. You can use standard :mod:`doctest` flags for
flags for controlling how actual output is compared with what you controlling how actual output is compared with what you give as output. The
give as output. The default set of flags is specified by the default set of flags is specified by the :confval:`doctest_default_flags`
:confval:`doctest_default_flags` configuration variable. configuration variable.
This directive supports two options: This directive supports two options:
@ -175,13 +175,14 @@ There are also these config values for customizing the doctest extension:
.. confval:: doctest_default_flags .. confval:: doctest_default_flags
By default, these options are enabled: ``ELLIPSIS`` (allowing you By default, these options are enabled: ``ELLIPSIS`` (allowing you to put
to put ellipses in the expected output that match anything in the ellipses in the expected output that match anything in the actual output),
actual output), ``IGNORE_EXCEPTION_DETAIL`` (everything following ``IGNORE_EXCEPTION_DETAIL`` (everything following the leftmost colon and any
the leftmost colon and any module information in the exception name module information in the exception name is ignored),
is ignored), ``DONT_ACCEPT_TRUE_FOR_1`` (by default, doctest ``DONT_ACCEPT_TRUE_FOR_1`` (by default, doctest accepts "True" in the output
accepts "True" in the output where "1" is given -- this is a relic where "1" is given -- this is a relic of pre-Python 2.2 times).
of pre-Python 2.2 times).
.. versionadded:: 1.5
.. confval:: doctest_path .. confval:: doctest_path