'Requires:
id -- id of current paragraph-definition
Returns:
an index of where the id occurs in list_of_lists, the
dictionary passed to this module.
Logic:
Iterate through the big lists, the one passed to this module and
get the first item, the dictionary. Use a counter to keep
track of how many times you iterate with the counter.
Once you find a match, return the counter.
If no match is found, print out an error message.'

def __get_index_of_list(self, id):

    if (id == '0'):
        return
    the_index = 0
    for list in self.__list_of_lists:
        the_dict = list[0]
        id_in_list = the_dict.get('list-id')
        if (id in id_in_list):
            return the_index
        the_index += 1
    if (self.__run_level > 0):
        sys.stderr.write(('Module    is    make_lists.py\nMethod    is    __get_index_of_list\nThe    main    list    does    not    appear    to    have    a    matching    id    for    %s    \n' % id))
