• 
      

    Upgrade Sphinx to 7.x.

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

    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.

    Summary ID
    Upgrade Sphinx to 7.x.
    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:` Testing Done: Built the RBTools manual and verified that everything worked well.
    6378faeb8d285827f6ac43098fe6b7c9570021be
    Description From Last Updated

    line too long (154 > 79 characters) Column: 80 Error code: E501

    reviewbotreviewbot

    line too long (158 > 79 characters) Column: 80 Error code: E501

    reviewbotreviewbot
    Checks run (1 failed, 1 succeeded)
    flake8 failed.
    JSHint passed.

    flake8

    chipx86
    1. Ship It!
    2. 
        
    david
    Review request changed
    Status:
    Completed
    Change Summary:
    Pushed to master (4d748af)