Refactoring: extracted MessageManager interface; also expanded javadoc
expanded javadoc
javadoc + cleanup