Document createEnvironment() methods

in AbstractApplicationContext and SpringContextResourceAdapter

org.springframework.context/src/main/java/org/springframework/context/support/AbstractApplicationContext.java

@@ -411,6 +411,8 @@ public abstract class AbstractApplicationContext extends DefaultResourceLoader
 
 	/**
 	 * Create and return a new {@link DefaultEnvironment}.
+	 * <p>Subclasses may override this method in order to supply
+	 * a custom {@link ConfigurableEnvironment} implementation.
 	 */
 	protected ConfigurableEnvironment createEnvironment() {
 		return new DefaultEnvironment();

org.springframework.transaction/src/main/java/org/springframework/jca/context/SpringContextResourceAdapter.java

@@ -144,10 +144,11 @@ public class SpringContextResourceAdapter implements ResourceAdapter {
 	}
 
 	/**
-	 * Return 
+	 * Return a new {@link DefaultEnvironment}.
+	 * <p>Subclasses may override this method in order to supply
+	 * a custom {@link ConfigurableEnvironment} implementation.
 	 */
 	protected ConfigurableEnvironment createEnvironment() {
-		// TODO: should actually return 
 		return new DefaultEnvironment();
 	}