Describe the bug
Setting the following option in conf.py has no effect:
suppress_warnings = ["toc.empty_glob"]
If I have this directive:
.. toctree::
:glob:
modules/*
And the "modules" folder is empty a warning about an "empty glob" is emitted.
This prevents me from using "--fail-on-warning".
How to Reproduce
- conf.py:
suppress_warnings = ['toc.empty_glob']
- index.rst
bug-demo documentation
======================
.. toctree::
:glob:
modules/*
- build command
uv run sphinx-build -M html . _build
Environment Information
Platform: linux; (Linux-6.17.0-22-generic-x86_64-with-glibc2.42)
Python version: 3.14.2 (main, Dec 17 2025, 21:08:09) [Clang 21.1.4 ])
Python implementation: CPython
Sphinx version: 9.1.1+/e44a40eb2
Docutils version: 0.22.3
Jinja2 version: 3.1.6
Pygments version: 2.19.2
Sphinx extensions
Additional context
No response
Describe the bug
Setting the following option in
conf.pyhas no effect:If I have this directive:
And the "modules" folder is empty a warning about an "empty glob" is emitted.
This prevents me from using "--fail-on-warning".
How to Reproduce
Environment Information
Sphinx extensions
Additional context
No response