Emit a warning if "language = None" setting found (refs: sphinx-doc#1…

…0474)
tk0miya · May 28, 2022 · 3d11413 · 3d11413
1 parent 63f3d26
commit 3d11413
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/sphinx/config.py b/sphinx/config.py
@@ -167,6 +167,9 @@ def read(cls, confdir: str, overrides: Dict = None, tags: Tags = None) -> "Confi
         # Resolve https://github.com/sphinx-doc/sphinx/issues/10474 where conf.py
         # explicitly sets language to None, by coercing it to English.
         if namespace.get("language", ...) is None:
+            logging.warning(__("Invalid configuration found: 'language = None'. "
+                               "Now it takes only a string. Please update your configuration. "
+                               "Fallback to 'en' (English)."))
             namespace["language"] = "en"
 
         return cls(namespace, overrides or {})