Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/sphinx-doc/sphinx.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJames Knight <james.d.knight@live.com>2021-12-05 23:03:57 +0300
committerJames Knight <james.d.knight@live.com>2021-12-05 23:03:57 +0300
commit75914c67c77e94b0af71fbab424ad1e18e218b97 (patch)
tree3ee897536e193fbe1d7e5d8cfe5c362b113b208a /sphinx/writers/texinfo.py
parentedd14783f3cc6222066fd63efbe28c2728617e18 (diff)
drop translator-specific unknown_visit calls
Removes the need for various translators from raising a `NotImplementedError` exception when missing support for a specific node type. docutils will already raise [1][2] a `NotImplementedError` exception for these cases. This help reduce the implementation inside Sphinx as well as prevents the possible undesired replication of unknown-node handling with third-party extensions [3]. In most cases, generating a warning message for an unsupported node type can be preferred. Providing an indication that a node is not supported can be easier for a user of Sphinx to understand a limitation of a builder over a generic "not implemented" exception. This commit takes the logging call which is already used by `texinfo` and applies it to the `SphinxTranslator` base class -- which any Sphinx translator implementation can use. [1]: https://repo.or.cz/docutils.git/blob/d169015ee0f412cffd69b33654d8a119d99bc0f3:/docutils/nodes.py#l2048 [2]: https://repo.or.cz/docutils.git/blob/53716a13b48128af6045139d3cd2909f61e7ed8e:/docutils/nodes.py#l1897 [3]: https://github.com/sphinx-doc/sphinx/issues/9921 Signed-off-by: James Knight <james.d.knight@live.com>
Diffstat (limited to 'sphinx/writers/texinfo.py')
-rw-r--r--sphinx/writers/texinfo.py4
1 files changed, 0 insertions, 4 deletions
diff --git a/sphinx/writers/texinfo.py b/sphinx/writers/texinfo.py
index 6df558323..539a72388 100644
--- a/sphinx/writers/texinfo.py
+++ b/sphinx/writers/texinfo.py
@@ -1265,10 +1265,6 @@ class TexinfoTranslator(SphinxTranslator):
logger.warning(__("unimplemented node type: %r"), node,
location=node)
- def unknown_visit(self, node: Node) -> None:
- logger.warning(__("unknown node type: %r"), node,
- location=node)
-
def unknown_departure(self, node: Node) -> None:
pass