Bump sphinx from 5.0.2 to 5.1.0

[dependabot]

Bumps sphinx from 5.0.2 to 5.1.0.

Release notes

Sourced from sphinx's releases.

v5.1.0

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

Changelog

Sourced from sphinx's changelog.

Release 5.1.0 (released Jul 24, 2022)

Dependencies

• #10656: Support Docutils 0.19_. Patch by Adam Turner.

.. _Docutils 0.19: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-19-2022-07-05

Deprecated

• #10467: Deprecated sphinx.util.stemmer in favour of snowballstemmer. Patch by Adam Turner.
• #9856: Deprecated sphinx.ext.napoleon.iterators.

Features added

• #10444: html theme: Allow specifying multiple CSS files through the stylesheet setting in theme.conf or by setting html_style to an iterable of strings.
• #10366: std domain: Add support for emphasising placeholders in :rst:dir:option directives through a new :confval:option_emphasise_placeholders configuration option.
• #10439: std domain: Use the repr of some variables when displaying warnings, making whitespace issues easier to identify.
• #10571: quickstart: Reduce content in the generated conf.py file. Patch by Pradyun Gedam.
• #10648: LaTeX: CSS-named-alike additional :ref:'sphinxsetup' <latexsphinxsetup> keys allow to configure four separate border-widths, four paddings, four corner radii, a shadow (possibly inset), colours for border, background, shadow for each of the code-block, topic, attention, caution, danger, error and warning directives.
• #10655: LaTeX: Explain non-standard encoding in LatinRules.xdy
• #10599: HTML Theme: Wrap consecutive footnotes in an <aside> element when using Docutils 0.18 or later, to allow for easier styling. This matches the behaviour introduced in Docutils 0.19. Patch by Adam Turner.
• #10518: config: Add include_patterns as the opposite of exclude_patterns. Patch by Adam Turner.

Bugs fixed

• #10594: HTML Theme: field term colons are doubled if using Docutils 0.18+
• #10596: Build failure if Docutils version is 0.18 (not 0.18.1) due to missing Node.findall()
• #10506: LaTeX: build error if highlighting inline code role in figure caption (refs: #10251)
• #10634: Make -P (pdb) option work better with exceptions triggered from events

... (truncated)

Commits

• cc1f6cb Bump to 5.1.0 final
• 8effd15 Update message catalogs (#10698)
• e3337c7 Update include_patterns implementation (#10680)
• 89db13d Merge pull request #10676 from AA-Turner/authors
• 40caf0c Merge pull request #10696 from jfbu/latex_fix_for_old_latex
• d1b4a75 LaTeX: fix another incompatibility with old pict2e LaTeX
• faccc21 Fix #10695: old LaTeX does not allow @​ifpackageloaded usage in body
• afac558 Merge branch '5.0.x' into 5.x
• 94f62e7 Merge pull request #10693 from tk0miya/mypy-0.971
• 5b89c39 Fix mypy violations (with mypy-0.971)
• 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)

[softwarefactory-project-zuul]

Build failed. More information on how to proceed and troubleshoot errors available at https://fedoraproject.org/wiki/Zuul-based-ci

✔️ fi-tox-mypy SUCCESS in 7m 21s
✔️ fi-tox-lint SUCCESS in 6m 49s
✔️ fi-tox-format SUCCESS in 6m 00s
❌ fi-tox-python38 FAILURE in 7m 08s
❌ fi-tox-python39 FAILURE in 7m 04s
❌ fi-tox-python310 FAILURE in 6m 55s
❌ fi-tox-docs FAILURE in 6m 53s
✔️ fi-tox-bandit SUCCESS in 6m 04s
❌ fi-tox-diff-cover FAILURE in 7m 19s

[Zlopez]

@dependabot rebase

[softwarefactory-project-zuul]

Build failed. More information on how to proceed and troubleshoot errors available at https://fedoraproject.org/wiki/Zuul-based-ci

✔️ fi-tox-mypy SUCCESS in 4m 31s
✔️ fi-tox-lint SUCCESS in 3m 35s
✔️ fi-tox-format SUCCESS in 3m 35s
✔️ fi-tox-python38 SUCCESS in 6m 57s
✔️ fi-tox-python39 SUCCESS in 6m 54s
✔️ fi-tox-python310 SUCCESS in 7m 11s
❌ fi-tox-docs FAILURE in 4m 33s
✔️ fi-tox-bandit SUCCESS in 3m 42s
✔️ fi-tox-diff-cover SUCCESS in 7m 59s

[softwarefactory-project-zuul]

Build failed. More information on how to proceed and troubleshoot errors available at https://fedoraproject.org/wiki/Zuul-based-ci

✔️ fi-tox-mypy SUCCESS in 5m 01s
✔️ fi-tox-lint SUCCESS in 3m 46s
✔️ fi-tox-format SUCCESS in 4m 38s
✔️ fi-tox-python38 SUCCESS in 7m 57s
✔️ fi-tox-python39 SUCCESS in 8m 16s
✔️ fi-tox-python310 SUCCESS in 8m 14s
❌ fi-tox-docs FAILURE in 4m 56s
✔️ fi-tox-bandit SUCCESS in 4m 06s
✔️ fi-tox-diff-cover SUCCESS in 9m 50s

[Zlopez]

Issue happening during tests was reported to Sphinx project sphinx-doc/sphinx#10705

[dependabot]

Superseded by #1426.