Added the universal.StripComments transform, the "strip_comments" setting, and the --strip-comments/--leave-comments options.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@4183 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

1 files changed, 15 insertions, 0 deletions

diff --git a/docutils/transforms/universal.py b/docutils/transforms/universal.py
index a6a0462cb..b31648632 100644
--- a/docutils/transforms/universal.py
+++ b/docutils/transforms/universal.py
@@ -154,3 +154,18 @@ class TestMessages(Transform):
         for msg in self.document.transform_messages:
             if not msg.parent:
                 self.document += msg
+
+
+class StripComments(Transform):
+
+    """
+    Remove comment elements from the document tree (only if the
+    ``strip_comments`` setting is enabled).
+    """
+
+    default_priority = 740
+
+    def apply(self):
+        if self.document.settings.strip_comments:
+            for node in self.document.traverse(nodes.comment):
+                node.parent.remove(node)