mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
Incorporated feeback on doc for doctest_default_flags (#2471).
This commit is contained in:
parent
8c1d9cc71c
commit
604b45d44b
@ -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
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user