message system polish

spring-binding/src/main/java/org/springframework/binding/message/DefaultMessageContext.java

@@ -34,7 +34,8 @@ import org.springframework.core.style.ToStringCreator;
 import org.springframework.util.CachingMapDecorator;
 
 /**
- * Default message context implementation.
+ * The default message context implementation. Uses a {@link MessageSource} to resolve messages that are added by
+ * callers.
  * 
  * @author Keith Donald
  */
@@ -51,7 +52,8 @@ public class DefaultMessageContext implements StateManageableMessageContext {
 	};
 
 	/**
-	 * Creates a new default message context.
+	 * Creates a new default message context. Defaults to a message source that simply resolves default text and cannot
+	 * resolve localized message codes.
 	 */
 	public DefaultMessageContext() {
 		init(null);
@@ -59,7 +61,7 @@ public class DefaultMessageContext implements StateManageableMessageContext {
 
 	/**
 	 * Creates a new default message context.
-	 * @param messageSource the message source to resolve messages added to this context (may be null)
+	 * @param messageSource the message source to resolve messages added to this context
 	 */
 	public DefaultMessageContext(MessageSource messageSource) {
 		init(messageSource);

spring-binding/src/main/java/org/springframework/binding/message/StateManageableMessageContext.java

@@ -42,7 +42,8 @@ public interface StateManageableMessageContext extends MessageContext {
 	public void restoreMessages(Serializable messagesMemento);
 
 	/**
-	 * Configure the message source used to resolve messages added to this context.
+	 * Configure the message source used to resolve messages added to this context. May be set at any time to change how
+	 * coded messages are resolved.
 	 * @param messageSource the message source
 	 * @see MessageContext#addMessage(MessageResolver)
 	 */