Update dependency sphinx to v8

[renovate]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
sphinx (changelog)	==7.4.7 -> ==8.0.2

---

Release Notes

sphinx-doc/sphinx (sphinx)

v8.0.2: Sphinx 8.0.2

Compare Source

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

v8.0.1: Sphinx 8.0.1

Compare Source

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

v8.0.0: Sphinx 8.0.0

Compare Source

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

Dependencies

• #​12633: Drop Python 3.9 support.

Incompatible changes

• Remove deprecated functions from sphinx.util:

  • Removed sphinx.util.path_stabilize
    (use sphinx.util.osutil.path_stabilize).
  • Removed sphinx.util.display_chunk
    (use sphinx.util.display.display_chunk).
  • Removed sphinx.util.status_iterator
    (use sphinx.util.display.status_iterator).
  • Removed sphinx.util.SkipProgressMessage
    (use sphinx.util.display.SkipProgressMessage).
  • Removed sphinx.util.progress_message
    (use sphinx.util.display.progress_message).
  • Removed sphinx.util.epoch_to_rfc1123
    (use sphinx.http_date.epoch_to_rfc1123).
  • Removed sphinx.util.rfc1123_to_epoch
    (use sphinx.http_date.rfc1123_to_epoch).
  • Removed sphinx.util.save_traceback
    (use sphinx.exceptions.save_traceback).
  • Removed sphinx.util.format_exception_cut_frames
    (use sphinx.exceptions.format_exception_cut_frames).
  • Removed sphinx.util.xmlname_checker
    (use sphinx.builders.epub3._XML_NAME_PATTERN).

  Patch by Adam Turner.

• Removed sphinx.util.osutil.cd
  (use contextlib.chdir).
  Patch by Adam Turner.

• Removed sphinx.util.typing.stringify
  (use sphinx.util.typing.stringify_annotation).
  Patch by Adam Turner.

• #​12593: Raise an error for invalid html_sidebars values.
  Patch by Adam Turner.

• #​12593: Raise an error in Theme.get_config for invalid sections.
  Patch by Adam Turner.

• #​11693: Remove support for old-style Makefile and make.bat
  output in sphinx-quickstart.

• #​11693: Remove the --no-use-make-mode, -M,
  --use-make-mode, and -m options
  from sphinx-quickstart.
  Patch by Adam Turner.

• Removed the tuple interface to sphinx.ext.autodoc.ObjectMember.
  Patch by Adam Turner.

• #​12630: Sphinx 8 makes two changes to the linkcheck configuration defaults:

  • linkcheck_allow_unauthorized is now False by default.
  • linkcheck_report_timeouts_as_broken is now False by default.

  Patch by James Addison.

• #​12597: Change the default of show_warning_types
  from False to True.
  Patch by Chris Sewell.

• #​12083: Remove support for the old (2008--2010) Sphinx 0.5 and Sphinx 0.6
  intersphinx_mapping format.
  Patch by Bénédikt Tran and Adam Turner.

• #​12096: Do not overwrite user-supplied files when copying assets
  unless forced with force=True.
  Patch by Adam Turner.

• #​12646: Remove sphinx.util.inspect.isNewType.
  Use isinstance(obj, typing.NewType) instead on Python 3.10 and newer.
  Patch by Adam Turner.

• Remove the long-deprecated (since Sphinx 2) alias
  to VersionChange in
  sphinx.directives.other
  (Deprecated since Sphinx 2).
  Use sphinx.domains.changeset.VersionChange directly.
  Patch by Adam Turner.

Deprecated

• #​12643: Renamed sphinx.ext.intersphinx.normalize_intersphinx_mapping
  to sphinx.ext.intersphinx.validate_intersphinx_mapping.
  The old name will be removed in Sphinx 10.
  Patch by Adam Turner.
• #​12650, #​12686, #​12690: Extend the deprecation for string methods on
  pathlib.Path objects to Sphinx 9.
  Use os.fspath to convert :py:class:~pathlib.Path objects to strings,
  or pathlib.Path's methods to work with path objects.
  Patch by Adam Turner.

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[bubeck]

We will not (yet) update sphinx to v8, as this requires Python 3.10 as a minimum. However, it is only needed for development, so this might be possible.