diff --git a/build-spring-framework/readme.txt b/build-spring-framework/readme.txt
index 71e840b58de..5b001a6cc51 100644
--- a/build-spring-framework/readme.txt
+++ b/build-spring-framework/readme.txt
@@ -1,27 +1,42 @@
-This is where the master build that creates releases of Spring Framework resides.  The build system is based on spring-build, which is linked in using an SVN external to https://src.springframework.org/svn/spring-build.
+This is where the master build that creates releases of Spring Framework resides.
+The build system is based on spring-build, which is linked in using an SVN
+external to https://src.springframework.org/svn/spring-build.
+
+Build Pre-requisites:
+- javac 1.6 or > must be in your system path
+- ant 1.7 or > must be in your system path
+- set ANT_OPTS as follows (to avoid out of memory errors):
+    ANT_OPTS="-XX:MaxPermSize=1024m -Xmx1024m -Dtest.vm.args='-XX:MaxPermSize=512m -Xmx1024m'"
 
 USERS
 - To build all Spring Framework projects, including samples:
 
     1. From this directory, run:
        ant
-        
-Build Pre-requisites:
-- javac 1.6 or > must be in your system path
-- ant 1.7 or > must be in your system path
+
+- To install the built artifacts into your local Maven cache:
+
+    1. From this directory, run:
+       ant install-maven
+
+- For a complete tutorial, see:
+
+       http://blog.springsource.com/2009/03/03/building-spring-3
+
 
 DEVELOPERS
 - To build a new Spring Framework distribution for release:
 
-  1. Update the files containing the version number to reflect the new release version, if necessary.
-	
+  1. Update the files containing the version number to reflect the new release
+     version, if necessary.
+
          build.properties
          build-spring-framework/resources/readme.txt
          spring-framework/src/spring-framework-reference.xml
 
   2. From this directory, run:
-	
+
          ant jar package
-		
+
      The release archive will be created and placed in:
-         target/artifacts
\ No newline at end of file
+         target/artifacts
diff --git a/build-spring-framework/resources/readme.txt b/build-spring-framework/resources/readme.txt
index 14d50f47ff8..e0245475d58 100644
--- a/build-spring-framework/resources/readme.txt
+++ b/build-spring-framework/resources/readme.txt
@@ -1,4 +1,4 @@
-SPRING FRAMEWORK 3.0.5 (October 2010)
+SPRING FRAMEWORK 3.1 M1 (January 2011)
 -------------------------------------
 http://www.springframework.org