Skip to content

"empty glob" warnings cannot be suppressed. #14625

Description

@exhuma

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions