Upgrade Sphinx to 7.x.

Review Request #14492 — Created June 28, 2025 and submitted — Latest diff uploaded

Information

RBTools
master

Reviewers

This change upgrades Sphinx for RBTools to the latest 7.x release and
bumps the sphinx-tabs extension to the latest version as well. There are
several things that appeared as warnings that I've fixed up:

  • We were listing rbtools.commands twice in the coderef index.
  • The source_suffix setting was changed long ago from a simple string
    to a dictionary. The older version we were on silently dealt with it,
    but 7.x warns.
  • We were triggering a warning about circular references from some
    changes in autosummary. I've added the recommended workaround,
    suppressing those warnings.
  • configuration/tfs.rst had an underline that wasn't the length of the
    header.
  • Added a few __autodoc_excludes__ lines to prevent warnings about
    conflicting references.
  • The SquashedDiff and DiffHistory namedtuples were triggering some
    weird warnings about duplicate fields in the generated docs. Switching
    to typed NamedTuple classes fixes these.
  • The inline-link syntax used in docstrings in the SOS code was wrong.
  • Several doc comments in config/config.py were using :rbt-command:
    instead of :rbtcommand:

Built the RBTools manual and verified that everything worked well.

Commits

Files