There's a better way to deal with the "comment" environment; I found
this in SF patch #732174.
diff --git a/Doc/tools/py2texi.el b/Doc/tools/py2texi.el
index 969cdc6..f9d8b96 100644
--- a/Doc/tools/py2texi.el
+++ b/Doc/tools/py2texi.el
@@ -85,6 +85,7 @@
      (progn (setq obindex t)
 	    "\n@table @code\n@item \\1\n@obindex \\1\n")
      "@end table\n")
+    ("comment" 0 "\n@ignore\n" "\n@end ignore\n")
     ("csimplemacrodesc" 1
      (progn (setq cindex t)
 	    "\n@table @code\n@item \\1\n@cindex \\1\n")