Document simplified doctest usage (#186)

Author: felix-hilden

docs/src/examples.rst

@@ -215,21 +215,13 @@ Please specify a ``type`` in :rst:dir:`autolink-examples`:
 
 Doctest code blocks
 -------------------
-Using the ``sphinx.ext.doctest`` extension for code examples requires
-setting up :confval:`codeautolink_custom_blocks`.
-To help in that, :func:`clean_pycon <sphinx_codeautolink.clean_pycon>`
-is provided as a ready-made transformer.
-
-.. code:: python
+Using the ``sphinx.ext.doctest`` extension for code examples only requires
+activating the extension::
 
    extensions = [
        ...,
        "sphinx.ext.doctest",
    ]
-   codeautolink_custom_blocks = {
-       "python3": None,
-       "pycon3": "sphinx_codeautolink.clean_pycon",
-   }
 
 ``doctest`` and ``testcode`` blocks now work as expected.
 However, any test setup and teardown code is not taken into account.

tests/extension/ref/lexer_extdoctest_doctest.txt

@@ -4,10 +4,7 @@ attr
 test_project.Foo
 test_project.Foo
 # split
-from sphinx_codeautolink.extension.block import clean_pycon
 extensions.append("sphinx.ext.doctest")
-codeautolink_custom_blocks = {"pycon3": clean_pycon}
-suppress_warnings = ["config.cache"]
 # split
 Test project
 ============

tests/extension/ref/lexer_extdoctest_testcode.txt

@@ -5,7 +5,6 @@ test_project.Foo
 test_project.Foo
 # split
 extensions.append("sphinx.ext.doctest")
-codeautolink_custom_blocks = {"python3": None}
 # split
 Test project
 ============