Sphinx 6.1

Release 6.1.3 (released Jan 10, 2023)

Bugs fixed

  • #11116: Reverted to previous Sphinx 5 node copying method

  • #11117: Reverted changes to parallel image processing from Sphinx 6.1.0

  • #11119: Suppress ValueError in the linkcheck builder

Release 6.1.2 (released Jan 07, 2023)

Bugs fixed

  • #11101: LaTeX: div.topic_padding key of sphinxsetup documented at 5.1.0 was implemented with name topic_padding

  • #11099: LaTeX: shadowrule key of sphinxsetup causes PDF build to crash since Sphinx 5.1.0

  • #11096: LaTeX: shadowsize key of sphinxsetup causes PDF build to crash since Sphinx 5.1.0

  • #11095: LaTeX: shadow of topic and contents boxes not in page margin since Sphinx 5.1.0

  • #11100: Fix copying images when running under parallel mode.

Release 6.1.1 (released Jan 05, 2023)

Bugs fixed

  • #11091: Fix util.nodes.apply_source_workaround for literal_block nodes with no source information in the node or the node’s parents.

Release 6.1.0 (released Jan 05, 2023)

Dependencies

  • Adopted the Ruff code linter.

Incompatible changes

  • #10979: gettext: Removed support for pluralisation in get_translation. This was unused and complicated other changes to sphinx.locale.

Deprecated

  • sphinx.util functions:

    • Renamed sphinx.util.typing.stringify() to sphinx.util.typing.stringify_annotation()

    • Moved sphinx.util.xmlname_checker() to sphinx.builders.epub3._XML_NAME_PATTERN

    Moved to sphinx.util.display:

    • sphinx.util.status_iterator

    • sphinx.util.display_chunk

    • sphinx.util.SkipProgressMessage

    • sphinx.util.progress_message

    Moved to sphinx.util.http_date:

    • sphinx.util.epoch_to_rfc1123

    • sphinx.util.rfc1123_to_epoch

    Moved to sphinx.util.exceptions:

    • sphinx.util.save_traceback

    • sphinx.util.format_exception_cut_frames

Features added

  • Cache doctrees in the build environment during the writing phase.

  • Make all writing phase tasks support parallel execution.

  • #11072: Use PEP 604 (X | Y) display conventions for typing.Optional and typing.Optional types within the Python domain and autodoc.

  • #10700: autodoc: Document typing.NewType() types as classes rather than ‘data’.

  • Cache doctrees between the reading and writing phases.

Bugs fixed

  • #10962: HTML: Fix the multi-word key name lookup table.

  • Fixed support for Python 3.12 alpha 3 (changes in the enum module).

  • #11069: HTML Theme: Removed outdated “shortcut” link relation keyword.

  • #10952: Properly terminate parallel processes on programme interruption.

  • #10988: Speed up TocTree.resolve() through more efficient copying.

  • #6744: LaTeX: support for seealso directive should be via an environment to allow styling.

  • #11074: LaTeX: Can’t change sphinxnote to use sphinxheavybox starting with 5.1.0