From 6b10052544cb749fce5f457cab051a168b77c1b8 Mon Sep 17 00:00:00 2001 From: Alex Marchenko Date: Fri, 21 Nov 2025 21:06:33 -0500 Subject: [PATCH 1/2] fix(multiple_toc_parents): Sets this log message to warning level to support suppress_warning feature --- sphinx/environment/__init__.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sphinx/environment/__init__.py b/sphinx/environment/__init__.py index fa7d17d7800..c98f17c3ca8 100644 --- a/sphinx/environment/__init__.py +++ b/sphinx/environment/__init__.py @@ -936,7 +936,7 @@ def _check_toc_parents(toctree_includes: dict[str, list[str]]) -> None: for doc, parents in sorted(toc_parents.items()): if len(parents) > 1: - logger.info( + logger.warning( __( 'document is referenced in multiple toctrees: %s, selecting: %s <- %s' ), From 3e56c54177b9219031e1357d2543a638b251c79a Mon Sep 17 00:00:00 2001 From: Alex Marchenko Date: Fri, 21 Nov 2025 21:13:43 -0500 Subject: [PATCH 2/2] chore(multiple_toc_parents): Suppresses toc.multiple_toc_parents in docs build --- doc/conf.py | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/conf.py b/doc/conf.py index ef28f92ff1a..315cee38a07 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -24,6 +24,7 @@ coverage_statistics_to_report = coverage_statistics_to_stdout = True templates_path = ['_templates'] exclude_patterns = ['_build'] +suppress_warnings = ['toc.multiple_toc_parents'] project = 'Sphinx' copyright = '2007-%Y, the Sphinx developers'