add javadoc
add MessageManager methods for getting display location instances, with or without filters