added a note.  eventually i think we need to fully support maps that let items occur twice.  lots of stuff will need to get updated for that to completely work though