simplified and completed the javadocs for MessageSource