Merge pull request #8345 from sphinx-doc/8342_warning_for_unknown_domain

Fix #8342: Emit a warning if a unknown domain is given for directive or role

CHANGES

@@ -43,6 +43,9 @@ Features added
 Bugs fixed
 ----------
 
+* #8342: Emit a warning if a unknown domain is given for directive or role (ex.
+  ``:unknown:doc:``)
+
 Testing
 --------
 

sphinx/util/docutils.py

@@ -28,6 +28,7 @@
 from docutils.utils import Reporter, unescape
 
 from sphinx.errors import SphinxError
+from sphinx.locale import _
 from sphinx.util import logging
 from sphinx.util.typing import RoleFunction
 
@@ -208,6 +209,8 @@ def lookup_domain_element(self, type: str, name: str) -> Any:
                 element = getattr(domain, type)(name)
                 if element is not None:
                     return element, []
+            else:
+                logger.warning(_('unknown directive or role name: %s:%s'), domain_name, name)
         # else look in the default domain
         else:
             def_domain = self.env.temp_data.get('default_domain')