DOP-1874: Ignore comment nodes in troff transform

Author: i80and

snooty/builders/man.py

@@ -1,4 +1,5 @@
 import io
+import logging
 from dataclasses import dataclass, field
 from enum import Enum, auto
 from typing import Dict, Iterable, List, Union, cast
@@ -7,6 +8,8 @@
 from ..page import Page
 from ..types import FileId
 
+logger = logging.getLogger(__name__)
+
 
 def troff_escape(value: str) -> str:
     """Escape values that troff may interpret."""
@@ -201,7 +204,13 @@ class SnootyToTroffTree:
     """Transforms snooty AST nodes to an intermediate representation of ManNodes."""
 
     def handle(self, node: n.Node) -> List[ManNode]:
-        return cast(List[ManNode], getattr(self, f"handle_{type(node).__name__}")(node))
+        try:
+            handler = getattr(self, f"handle_{type(node).__name__}")
+        except AttributeError:
+            logger.error("INTERNAL: Unknown node type: %s", type(node).__name__)
+            return []
+
+        return cast(List[ManNode], handler(node))
 
     def children(self, nodes: Iterable[n.Node]) -> List[ManNode]:
         list_of_lists = [self.handle(child) for child in nodes]
@@ -379,6 +388,9 @@ def handle_Transition(self, node: n.Transition) -> List[ManNode]:
     def handle_Table(self, node: n.Table) -> List[ManNode]:
         return []
 
+    def handle_Comment(self, node: n.Comment) -> List[ManNode]:
+        return []
+
 
 def render(page: Page, name: str, title: str, section: int) -> Dict[FileId, str]:
     """Render the given page as a manpage."""