Sphinx 8.0.0rc1

Sphinx 8.0.0rc1

on Python PyPI

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.

• #12650: Remove support for string methods on pathlib.Path objects.
  Use os.fspath to convert pathlib.Path objects to strings,
  or pathlib.Path's methods to work with path objects.
  Patch by Adam Turner.

• #12646: Remove sphinx.util.inspect.isNewType.
  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.

Full Changelog: v7.4.7...v8.0.0rc1