Python and the XML Document Object Model (DOM) with 4Suite

There's not much to this class: it stores the content in a DOM Comment node.

# - - - - -   c l a s s   C o m m e n t   - - - - -

class Comment:
    """Represents an XML comment."""


# - - -   C o m m e n t . _ _ i n i t _ _   - - -

    def __init__ ( self, parent, content ):
        """Constructor for a Comment object.
          [ parent is an Element object ->
              parent  :=  parent with a new comment node added with
                          text=content
            return a new Comment object representing that node ]
        """

        #-- 1 --
        # [ parent is an Element ->
        #     self.node  :=  a new DOM Comment node with content=content ]
        self.node  =  parent.doc.node.createComment ( content )

        #-- 2 --
        # [ parent  :=  parent with self.node added as its last or
        #               only child ]
        parent.node.appendChild ( self.node )