Merge pull request #10212 from AA-Turner/remove-module-docstring-titles

Remove module docstring titles

tests/conftest.py

@@ -1,11 +1,3 @@
-"""
-    pytest config for sphinx/tests
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
 import os
 import shutil
 

tests/ext_napoleon_pep526_data_google.py

@@ -1,6 +1,4 @@
-"""
-Test module for napoleon PEP 526 compatibility with google style
-"""
+"""Test module for napoleon PEP 526 compatibility with google style"""
 
 module_level_var: int = 99
 """This is an example module level variable"""

tests/ext_napoleon_pep526_data_numpy.py

@@ -1,6 +1,4 @@
-"""
-Test module for napoleon PEP 526 compatibility with numpy style
-"""
+"""Test module for napoleon PEP 526 compatibility with numpy style"""
 
 module_level_var: int = 99
 """This is an example module level variable"""

tests/roots/test-inheritance/dummy/test_nested.py

@@ -1,5 +1,4 @@
-"""
-    Test with nested classes.
+"""Test with nested classes.
 """
 
 

tests/test_api_translator.py

@@ -1,12 +1,4 @@
-"""
-    test_api_translator
-    ~~~~~~~~~~~~~~~~~~~
-
-    Test the Sphinx API for translator.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the Sphinx API for translator."""
 
 import sys
 

tests/test_application.py

@@ -1,12 +1,4 @@
-"""
-    test_application
-    ~~~~~~~~~~~~~~~~
-
-    Test the Sphinx class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the Sphinx class."""
 
 from unittest.mock import Mock
 

tests/test_build.py

@@ -1,12 +1,4 @@
-"""
-    test_build
-    ~~~~~~~~~~
-
-    Test all builders.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test all builders."""
 
 import sys
 from textwrap import dedent

tests/test_build_changes.py

@@ -1,12 +1,4 @@
-"""
-    test_build_changes
-    ~~~~~~~~~~~~~~~~~~
-
-    Test the ChangesBuilder class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the ChangesBuilder class."""
 
 import pytest
 

tests/test_build_dirhtml.py

@@ -1,12 +1,4 @@
-"""
-    test_build_dirhtml
-    ~~~~~~~~~~~~~~~~~~
-
-    Test dirhtml builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test dirhtml builder."""
 
 import posixpath
 

tests/test_build_epub.py

@@ -1,12 +1,4 @@
-"""
-    test_build_html
-    ~~~~~~~~~~~~~~~
-
-    Test the HTML builder and check output against XPath.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the HTML builder and check output against XPath."""
 
 import os
 import subprocess

tests/test_build_gettext.py

@@ -1,12 +1,4 @@
-"""
-    test_build_gettext
-    ~~~~~~~~~~~~~~~~~~
-
-    Test the build process with gettext builder with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the build process with gettext builder with the test root."""
 
 import gettext
 import os

tests/test_build_html.py

@@ -1,12 +1,4 @@
-"""
-    test_build_html
-    ~~~~~~~~~~~~~~~
-
-    Test the HTML builder and check output against XPath.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the HTML builder and check output against XPath."""
 
 import os
 import re

tests/test_build_latex.py

@@ -1,12 +1,4 @@
-"""
-    test_build_latex
-    ~~~~~~~~~~~~~~~~
-
-    Test the build process with LaTeX builder with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the build process with LaTeX builder with the test root."""
 
 import os
 import re

tests/test_build_linkcheck.py

@@ -1,12 +1,4 @@
-"""
-    test_build_linkcheck
-    ~~~~~~~~~~~~~~~~~~~~
-
-    Test the build process with manpage builder with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the build process with manpage builder with the test root."""
 
 import http.server
 import json

tests/test_build_manpage.py

@@ -1,12 +1,4 @@
-"""
-    test_build_manpage
-    ~~~~~~~~~~~~~~~~~~
-
-    Test the build process with manpage builder with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the build process with manpage builder with the test root."""
 
 import pytest
 

tests/test_build_texinfo.py

@@ -1,12 +1,4 @@
-"""
-    test_build_texinfo
-    ~~~~~~~~~~~~~~~~~~
-
-    Test the build process with Texinfo builder with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the build process with Texinfo builder with the test root."""
 
 import os
 import re

tests/test_build_text.py

@@ -1,12 +1,4 @@
-"""
-    test_build_text
-    ~~~~~~~~~~~~~~~
-
-    Test the build process with Text builder with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the build process with Text builder with the test root."""
 
 import pytest
 from docutils.utils import column_width

tests/test_builder.py

@@ -1,12 +1,4 @@
-"""
-    test_builder
-    ~~~~~~~~
-
-    Test the Builder class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the Builder class."""
 import pytest
 
 

tests/test_catalogs.py

@@ -1,12 +1,4 @@
-"""
-    test_build_base
-    ~~~~~~~~~~~~~~~
-
-    Test the base build process.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the base build process."""
 import shutil
 
 import pytest

tests/test_config.py

@@ -1,13 +1,4 @@
-"""
-    test_config
-    ~~~~~~~~~~~
-
-    Test the sphinx.config.Config class and its handling in the
-    Application class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the sphinx.config.Config class."""
 
 from unittest import mock
 

tests/test_correct_year.py

@@ -1,12 +1,4 @@
-"""
-    test_correct_year
-    ~~~~~~~~~~~~~~~~~
-
-    Test copyright year adjustment
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test copyright year adjustment"""
 import pytest
 
 

tests/test_directive_code.py

@@ -1,12 +1,4 @@
-"""
-    test_directive_code
-    ~~~~~~~~~~~~~~~~~~~
-
-    Test the code-block directive.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the code-block directive."""
 
 import os
 

tests/test_directive_only.py

@@ -1,12 +1,4 @@
-"""
-    test_only_directive
-    ~~~~~~~~~~~~~~~~~~~
-
-    Test the only directive with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the only directive with the test root."""
 
 import re
 

tests/test_directive_other.py

@@ -1,12 +1,4 @@
-"""
-    test_directive_other
-    ~~~~~~~~~~~~~~~~~~~~
-
-    Test the other directives.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the other directives."""
 
 import pytest
 from docutils import nodes

tests/test_directive_patch.py

@@ -1,12 +1,4 @@
-"""
-    test_directive_patch
-    ~~~~~~~~~~~~~~~~~~~
-
-    Test the patched directives.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the patched directives."""
 
 import pytest
 from docutils import nodes

tests/test_docutilsconf.py

@@ -1,12 +1,4 @@
-"""
-    test_docutilsconf
-    ~~~~~~~~~~~~~~~~~
-
-    Test docutils.conf support for several writers.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test docutils.conf support for several writers."""
 
 import pytest
 from docutils import nodes

tests/test_domain_c.py

@@ -1,12 +1,4 @@
-"""
-    test_domain_c
-    ~~~~~~~~~~~~~
-
-    Tests the C Domain
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the C Domain"""
 
 import itertools
 import zlib

tests/test_domain_cpp.py

@@ -1,12 +1,4 @@
-"""
-    test_domain_cpp
-    ~~~~~~~~~~~~~~~
-
-    Tests the C++ Domain
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the C++ Domain"""
 
 import itertools
 import re

tests/test_domain_js.py

@@ -1,12 +1,4 @@
-"""
-    test_domain_js
-    ~~~~~~~~~~~~~~
-
-    Tests the JavaScript Domain
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the JavaScript Domain"""
 
 from unittest.mock import Mock
 

tests/test_domain_py.py

@@ -1,12 +1,4 @@
-"""
-    test_domain_py
-    ~~~~~~~~~~~~~~
-
-    Tests the Python Domain
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the Python Domain"""
 
 import re
 import sys

tests/test_domain_rst.py

@@ -1,12 +1,4 @@
-"""
-    test_rst_domain
-    ~~~~~~~~~~~~~~~
-
-    Tests the reStructuredText domain.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the reStructuredText domain."""
 
 from sphinx import addnodes
 from sphinx.addnodes import (desc, desc_addname, desc_annotation, desc_content, desc_name,

tests/test_domain_std.py

@@ -1,12 +1,4 @@
-"""
-    test_domain_std
-    ~~~~~~~~~~~~~~~
-
-    Tests the std domain
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the std domain"""
 
 from unittest import mock
 

tests/test_environment.py

@@ -1,12 +1,4 @@
-"""
-    test_env
-    ~~~~~~~~
-
-    Test the BuildEnvironment class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the BuildEnvironment class."""
 import os
 import shutil
 

tests/test_environment_indexentries.py

@@ -1,12 +1,4 @@
-"""
-    test_environment_indexentries
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the sphinx.environment.managers.indexentries.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the sphinx.environment.managers.indexentries."""
 
 import pytest
 

tests/test_environment_toctree.py

@@ -1,12 +1,4 @@
-"""
-    test_environment_toctree
-    ~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the sphinx.environment.managers.toctree.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the sphinx.environment.managers.toctree."""
 
 import pytest
 from docutils import nodes

tests/test_events.py

@@ -1,12 +1,4 @@
-"""
-    test_events
-    ~~~~~~~~~~~
-
-    Test the EventManager class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the EventManager class."""
 
 import pytest
 

tests/test_ext_apidoc.py

@@ -1,12 +1,4 @@
-"""
-    test_apidoc
-    ~~~~~~~~~~~
-
-    Test the sphinx.apidoc module.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the sphinx.apidoc module."""
 
 from collections import namedtuple
 

tests/test_ext_autodoc.py

@@ -1,12 +1,7 @@
-"""
-    test_ext_autodoc
-    ~~~~~~~~~~~~~~~~
+"""Test the autodoc extension.
 
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
 import sys

tests/test_ext_autodoc_autoattribute.py

@@ -1,12 +1,7 @@
-"""
-    test_ext_autodoc_autoattribute
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Test the autodoc extension.
 
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
 import sys

tests/test_ext_autodoc_autoclass.py

@@ -1,12 +1,7 @@
-"""
-    test_ext_autodoc_autoclass
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Test the autodoc extension.
 
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
 import sys

tests/test_ext_autodoc_autodata.py

@@ -1,12 +1,7 @@
-"""
-    test_ext_autodoc_autodata
-    ~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Test the autodoc extension.
 
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
 import sys

tests/test_ext_autodoc_autofunction.py

@@ -1,12 +1,7 @@
-"""
-    test_ext_autodoc_autofunction
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Test the autodoc extension.
 
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
 import pytest

tests/test_ext_autodoc_automodule.py

@@ -1,12 +1,7 @@
-"""
-    test_ext_autodoc_autocmodule
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Test the autodoc extension.
 
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
 import sys

tests/test_ext_autodoc_autoproperty.py

@@ -1,12 +1,7 @@
-"""
-    test_ext_autodoc_autoproperty
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Test the autodoc extension.
 
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
 import sys

tests/test_ext_autodoc_configs.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_autodoc_configs
-    ~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.  This tests mainly for config variables
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the autodoc extension.  This tests mainly for config variables"""
 
 import platform
 import sys

tests/test_ext_autodoc_events.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_autodoc_events
-    ~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.  This tests mainly for autodoc events
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the autodoc extension.  This tests mainly for autodoc events"""
 
 import pytest
 

tests/test_ext_autodoc_mock.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_autodoc_mock
-    ~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the autodoc extension."""
 
 import abc
 import sys

tests/test_ext_autodoc_preserve_defaults.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_autodoc_preserve_defaults
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the autodoc extension."""
 
 import sys
 

tests/test_ext_autodoc_private_members.py

@@ -1,11 +1,4 @@
-"""
-    test_ext_autodoc_private_members
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.  This tests mainly for private-members option.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+"""Test the autodoc extension.  This tests mainly for private-members option.
 """
 
 import pytest

tests/test_ext_autosectionlabel.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_autosectionlabel
-    ~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.autosectionlabel extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.autosectionlabel extension."""
 
 import re
 

tests/test_ext_autosummary.py

@@ -1,12 +1,4 @@
-"""
-    test_autosummary
-    ~~~~~~~~~~~~~~~~
-
-    Test the autosummary extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the autosummary extension."""
 
 import sys
 from io import StringIO

tests/test_ext_coverage.py

@@ -1,12 +1,4 @@
-"""
-    test_coverage
-    ~~~~~~~~~~~~~
-
-    Test the coverage builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the coverage builder."""
 
 import pickle
 

tests/test_ext_doctest.py

@@ -1,12 +1,4 @@
-"""
-    test_doctest
-    ~~~~~~~~~~~~
-
-    Test the doctest extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the doctest extension."""
 import os
 from collections import Counter
 

tests/test_ext_duration.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_duration
-    ~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.duration extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.duration extension."""
 
 import re
 

tests/test_ext_githubpages.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_githubpages
-    ~~~~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.githubpages extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.githubpages extension."""
 
 import pytest
 

tests/test_ext_graphviz.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_graphviz
-    ~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.graphviz extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.graphviz extension."""
 
 import re
 

tests/test_ext_ifconfig.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_ifconfig
-    ~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.ifconfig extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.ifconfig extension."""
 
 import pytest
 

tests/test_ext_imgconverter.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_imgconverter
-    ~~~~~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.imgconverter extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.imgconverter extension."""
 
 import os
 

tests/test_ext_inheritance_diagram.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_inheritance_diagram
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.inheritance_diagram extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.inheritance_diagram extension."""
 
 import os
 import re

tests/test_ext_intersphinx.py

@@ -1,12 +1,4 @@
-"""
-    test_intersphinx
-    ~~~~~~~~~~~~~~~~
-
-    Test the intersphinx extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the intersphinx extension."""
 
 import http.server
 import os

tests/test_ext_math.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_math
-    ~~~~~~~~~~~~~
-
-    Test math extensions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test math extensions."""
 
 import re
 import subprocess

tests/test_ext_napoleon.py

@@ -1,13 +1,4 @@
-"""
-    test_napoleon
-    ~~~~~~~~~~~~~
-
-    Tests for :mod:`sphinx.ext.napoleon.__init__` module.
-
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests for :mod:`sphinx.ext.napoleon.__init__` module."""
 
 import sys
 from collections import namedtuple

tests/test_ext_napoleon_docstring.py

@@ -1,13 +1,4 @@
-"""
-    test_napoleon_docstring
-    ~~~~~~~~~~~~~~~~~~~~~~~
-
-    Tests for :mod:`sphinx.ext.napoleon.docstring` module.
-
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests for :mod:`sphinx.ext.napoleon.docstring` module."""
 
 import re
 import sys

tests/test_ext_napoleon_iterators.py

@@ -1,13 +1,4 @@
-"""
-    test_napoleon_iterators
-    ~~~~~~~~~~~~~~~~~~~~~~~
-
-    Tests for :mod:`sphinx.ext.napoleon.iterators` module.
-
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests for :mod:`sphinx.ext.napoleon.iterators` module."""
 
 from unittest import TestCase
 

tests/test_ext_todo.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_todo
-    ~~~~~~~~~~~~~
-
-    Test sphinx.ext.todo extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.todo extension."""
 
 import re
 

tests/test_ext_viewcode.py

@@ -1,12 +1,4 @@
-"""
-    test_ext_viewcode
-    ~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.viewcode extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.viewcode extension."""
 
 import re
 

tests/test_extension.py

@@ -1,12 +1,4 @@
-"""
-    test_extension
-    ~~~~~~~~~~~~~~
-
-    Test sphinx.extension module.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.extension module."""
 
 import pytest
 

tests/test_highlighting.py

@@ -1,12 +1,4 @@
-"""
-    test_highlighting
-    ~~~~~~~~~~~~~~~~~
-
-    Test the Pygments highlighting bridge.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the Pygments highlighting bridge."""
 
 from unittest import mock
 

tests/test_intl.py

@@ -1,12 +1,6 @@
-"""
-    test_intl
-    ~~~~~~~~~
+"""Test message patching for internationalization purposes.
 
-    Test message patching for internationalization purposes.  Runs the text
-    builder in the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+Runs the text builder in the test root.
 """
 
 import os

tests/test_locale.py

@@ -1,12 +1,4 @@
-"""
-    test_locale
-    ~~~~~~~~~~
-
-    Test locale.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test locale."""
 
 import pytest
 

tests/test_markup.py

@@ -1,12 +1,4 @@
-"""
-    test_markup
-    ~~~~~~~~~~~
-
-    Test various Sphinx-specific markup extensions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test various Sphinx-specific markup extensions."""
 
 import re
 

tests/test_metadata.py

@@ -1,12 +1,4 @@
-"""
-    test_metadata
-    ~~~~~~~~~~~~~
-
-    Test our handling of metadata in files with bibliographic metadata.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test our handling of metadata in files with bibliographic metadata."""
 
 # adapted from an example of bibliographic metadata at
 # https://docutils.sourceforge.io/docs/user/rst/demo.txt

tests/test_parser.py

@@ -1,12 +1,4 @@
-"""
-    test_sphinx_parsers
-    ~~~~~~~~~~~~~~~~~~~
-
-    Tests parsers module.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests parsers module."""
 
 from unittest.mock import Mock, patch
 

tests/test_project.py

@@ -1,12 +1,4 @@
-"""
-    test_project
-    ~~~~~~~~~~~~
-
-    Tests project module.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests project module."""
 
 from collections import OrderedDict
 

tests/test_pycode.py

@@ -1,12 +1,4 @@
-"""
-    test_pycode
-    ~~~~~~~~~~~
-
-    Test pycode.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test pycode."""
 
 import os
 import sys

tests/test_pycode_ast.py

@@ -1,12 +1,4 @@
-"""
-    test_pycode_ast
-    ~~~~~~~~~~~~~~~
-
-    Test pycode.ast
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test pycode.ast"""
 
 import sys
 

tests/test_pycode_parser.py

@@ -1,12 +1,4 @@
-"""
-    test_pycode_parser
-    ~~~~~~~~~~~~~~~~~~
-
-    Test pycode.parser.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test pycode.parser."""
 
 from sphinx.pycode.parser import Parser
 from sphinx.util.inspect import signature_from_str

tests/test_quickstart.py

@@ -1,12 +1,4 @@
-"""
-    test_quickstart
-    ~~~~~~~~~~~~~~~
-
-    Test the sphinx.quickstart module.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the sphinx.quickstart module."""
 
 import time
 from io import StringIO

tests/test_roles.py

@@ -1,12 +1,4 @@
-"""
-    test_roles
-    ~~~~~~~~~~
-
-    Test sphinx.roles
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.roles"""
 
 from unittest.mock import Mock
 

tests/test_search.py

@@ -1,12 +1,4 @@
-"""
-    test_search
-    ~~~~~~~~~~~
-
-    Test the search index builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the search index builder."""
 
 from collections import namedtuple
 from io import BytesIO

tests/test_setup_command.py

@@ -1,12 +1,4 @@
-"""
-    test_setup_command
-    ~~~~~~~~~~~~~~~~~~~
-
-    Test setup_command for distutils.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test setup_command for distutils."""
 
 import os
 import subprocess

tests/test_smartquotes.py

@@ -1,12 +1,4 @@
-"""
-    test_smartquotes
-    ~~~~~~~~~~~~~~~~
-
-    Test smart quotes.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test smart quotes."""
 
 import pytest
 from html5lib import HTMLParser

tests/test_templating.py

@@ -1,12 +1,4 @@
-"""
-    test_templating
-    ~~~~~~~~~~~~~~~~
-
-    Test templating.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test templating."""
 
 import pytest
 

tests/test_theming.py

@@ -1,12 +1,4 @@
-"""
-    test_theming
-    ~~~~~~~~~~~~
-
-    Test the Theme class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the Theme class."""
 
 import os
 

tests/test_toctree.py

@@ -1,12 +1,4 @@
-"""
-    test_toctree
-    ~~~~~~~~~~~~
-
-    Test the HTML builder and check output against XPath.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the HTML builder and check output against XPath."""
 import re
 
 import pytest

tests/test_transforms_post_transforms.py

@@ -1,12 +1,4 @@
-"""
-    test_transforms_post_transforms
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Tests the post_transforms
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the post_transforms"""
 
 import pytest
 from docutils import nodes

tests/test_transforms_post_transforms_code.py

@@ -1,11 +1,3 @@
-"""
-    test_transforms_post_transforms_code
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
 import pytest
 
 

tests/test_util.py

@@ -1,12 +1,4 @@
-"""
-    test_util
-    ~~~~~~~~~~~~~~~
-
-    Tests util functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests util functions."""
 
 import os
 import tempfile

tests/test_util_docstrings.py

@@ -1,12 +1,4 @@
-"""
-    test_util_docstrings
-    ~~~~~~~~~~~~~~~~~~~~
-
-    Test sphinx.util.docstrings.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.util.docstrings."""
 
 from sphinx.util.docstrings import prepare_commentdoc, prepare_docstring, separate_metadata
 

tests/test_util_docutils.py

@@ -1,12 +1,4 @@
-"""
-    test_util_docutils
-    ~~~~~~~~~~~~~~~~~~
-
-    Tests util.utils functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests util.utils functions."""
 
 import os
 

tests/test_util_fileutil.py

@@ -1,12 +1,4 @@
-"""
-    test_util_fileutil
-    ~~~~~~~~~~~~~~~~~~
-
-    Tests sphinx.util.fileutil functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests sphinx.util.fileutil functions."""
 
 from unittest import mock
 

tests/test_util_i18n.py

@@ -1,12 +1,4 @@
-"""
-    test_util_i18n
-    ~~~~~~~~~~~~~~
-
-    Test i18n util.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test i18n util."""
 
 import datetime
 import os

tests/test_util_images.py

@@ -1,12 +1,4 @@
-"""
-    test_util_images
-    ~~~~~~~~~~~~~~~~
-
-    Test images util.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test images util."""
 
 import pytest
 

tests/test_util_inspect.py

@@ -1,12 +1,4 @@
-"""
-    test_util_inspect
-    ~~~~~~~~~~~~~~~
-
-    Tests util.inspect functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests util.inspect functions."""
 
 import ast
 import datetime

tests/test_util_inventory.py

@@ -1,12 +1,4 @@
-"""
-    test_util_inventory
-    ~~~~~~~~~~~~~~~~~~~
-
-    Test inventory util functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test inventory util functions."""
 
 import posixpath
 import zlib

tests/test_util_logging.py

@@ -1,12 +1,4 @@
-"""
-    test_util_logging
-    ~~~~~~~~~~~~~~~~~
-
-    Test logging util.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test logging util."""
 
 import codecs
 import os

tests/test_util_matching.py

@@ -1,12 +1,4 @@
-"""
-    test_util_matching
-    ~~~~~~~~~~~~~~~~~~
-
-    Tests sphinx.util.matching functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests sphinx.util.matching functions."""
 from sphinx.util.matching import Matcher, compile_matchers
 
 

tests/test_util_nodes.py

@@ -1,12 +1,4 @@
-"""
-    test_util_nodes
-    ~~~~~~~~~~~~~~~
-
-    Tests uti.nodes functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests uti.nodes functions."""
 from textwrap import dedent
 from typing import Any
 

tests/test_util_rst.py

@@ -1,12 +1,4 @@
-"""
-    test_util_rst
-    ~~~~~~~~~~~~~~~
-
-    Tests sphinx.util.rst functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests sphinx.util.rst functions."""
 
 from docutils.statemachine import StringList
 from jinja2 import Environment

tests/test_util_template.py

@@ -1,12 +1,4 @@
-"""
-    test_util_template
-    ~~~~~~~~~~~~~~~~~~
-
-    Tests sphinx.util.template functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests sphinx.util.template functions."""
 
 from sphinx.util.template import ReSTRenderer