Bump sphinx from 5.1.1 to 5.2.1 in /docs

[dependabot]

Bumps sphinx from 5.1.1 to 5.2.1.

Release notes

Sourced from sphinx's releases.

v5.2.1

Changelog: https://www.sphinx-doc.org/en/master/changes.html

v5.2.0

Changelog: https://www.sphinx-doc.org/en/master/changes.html

Changelog

Sourced from sphinx's changelog.

Release 5.2.1 (released Sep 24, 2022)

Bugs fixed

• #10861: Always normalise the pycon3 lexer to pycon.
• Fix using sphinx.ext.autosummary with modules containing titles in the module-level docstring.

Release 5.2.0.post0 (released Sep 24, 2022)

• Recreated source tarballs for Debian maintainers.

Release 5.2.0 (released Sep 24, 2022)

Dependencies

• #10356: Sphinx now uses declarative metadata with pyproject.toml to create packages, using PyPA's flit project as a build backend. Patch by Adam Turner.

Deprecated

• #10843: Support for HTML 4 output. Patch by Adam Turner.

Features added

• #10738: napoleon: Add support for docstring types using 'of', like type of type. Example: tuple of int.
• #10286: C++, support requires clauses not just between the template parameter lists and the declaration.
• #10755: linkcheck: Check the source URL of raw directives that use the url option.
• #10781: Allow :rst:role:ref role to be used with definitions and fields.
• #10717: HTML Search: Increase priority for full title and subtitle matches in search results
• #10718: HTML Search: Save search result score to the HTML element for debugging
• #10673: Make toctree accept 'genindex', 'modindex' and 'search' docnames
• #6316, #10804: Add domain objects to the table of contents. Patch by Adam Turner
• #6692: HTML Search: Include explicit :rst:dir:index directive index entries in the search index and search results. Patch by Adam Turner
• #10816: imgmath: Allow embedding images in HTML as base64
• #10854: HTML Search: Use browser localstorage for highlight control, stop storing highlight parameters in URL query strings. Patch by Adam Turner.

... (truncated)

Commits

• e0dbbc5 Bump to 5.2.1 final
• 15c1cba Fix error in changelog for Sphinx 5.2.0
• 77cee67 Define extra indent as a class attribute
• 9ced736 Fix highlighting lexers
• cd24c54 Bump to 5.2.0.post0 final
• 911a5fe Bump to 5.2.0 final
• bc59a1d Merge 5.1.2 CHANGES into 5.2.0
• 2f2bd55 Merge pull request #10859 from jfbu/latex_doc_tableofcontentshook
• 89a656d LaTeX: improved doc of \sphinxtableofcontents (closes #10858)
• 6508121 Docstring clarifications (#9877)
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

[dependabot]

Dependabot tried to update this pull request, but something went wrong. We're looking into it, but in the meantime you can retry the update by commenting @dependabot rebase.

[sobolevn]

@dependabot-bot rebase

[dependabot]

Dependabot tried to update this pull request, but something went wrong. We're looking into it, but in the meantime you can retry the update by commenting @dependabot rebase.

[dependabot]

OK, I won't notify you again about this release, but will get in touch when a new version is available. If you'd rather skip all updates until the next major or minor version, let me know by commenting @dependabot ignore this major version or @dependabot ignore this minor version. You can also ignore all major, minor, or patch releases for a dependency by adding an ignore condition with the desired update_types to your config file.

If you change your mind, just re-open this PR and I'll resolve any conflicts on it.