xnomo3.py: Internal maintenance specification

This method builds the .__collMap dictionary using the COLLISION_SET_N node.

# - - -   T x n y . _ _ r e a d C o l l i s i o n s   - - -

    def __readCollisions ( self, collSetNode ):
        """Read the COLLISION_SET_N node and build self.__collMap.
        """
      
        #-- 1 --
        self.__collMap = {}

        #-- 2 --
        # [ self.__collMap  +:=  entries mapping BAD_ABBR_A attributes
        #       from children of collSetNode |-> lists of the codes
        #       from the content of GOOD_ABBR_N element children of
        #       those children ]
        for  collNode in collSetNode.findall(rnc.COLLISION_N):
            #-- 2 body --
            # [ collNode is a COLLISION_N Element ->
            #     self.__collMap  +:=  an entry mapping the BAD_ABBR_A
            #         attribute of collNode |-> a list of the codes
            #         from the content of GOOD_ABBR_N element children
            #         of collNode ]
            self.__addCollision ( collNode )