add comments to clarify intended usage of internal map listener adapter