diff --git a/spring-framework-reference/src/new-in-3.1.xml b/spring-framework-reference/src/new-in-3.1.xml
new file mode 100644
index 00000000000..2cad62c8eb5
--- /dev/null
+++ b/spring-framework-reference/src/new-in-3.1.xml
@@ -0,0 +1,182 @@
+
+
+
+ New Features and Enhancements in Spring 3.1
+
+ Building on the support introduced in Spring 3.0, Spring 3.1 is
+ currently under development, and at the time of this writing Spring 3.1 M2
+ has just been released.
+
+
+ Overview of new features
+
+ This is a list of new features for Spring 3.1. Most features
+ do not yet have dedicated reference documentation but do have
+ Javadoc. In these cases, fully-qualified classnames are given.
+
+
+ Cache Abstraction
+
+
+
+
+
+
+ Cache Abstraction (SpringSource team blog)
+
+
+
+
+ Bean Definition Profiles
+
+
+
+ XML profiles (SpringSource Team Blog)
+
+
+
+ Introducing @Profile (SpringSource Team Blog)
+
+
+ See org.springframework.context.annotation.Configuration Javadoc
+
+
+ See org.springframework.context.annotation.Profile Javadoc
+
+
+
+
+ Environment Abstraction
+
+
+
+ Environment Abstraction (SpringSource Team Blog)
+
+
+ See org.springframework.core.env.Environment Javadoc
+
+
+
+
+ PropertySource Abstraction
+
+
+
+ Unified Property Management (SpringSource Team Blog)
+
+
+ See org.springframework.core.env.Environment Javadoc
+
+
+ See org.springframework.core.env.PropertySource Javadoc
+
+
+ See org.springframework.context.annotation.PropertySource Javadoc
+
+
+
+
+ Code equivalents for Spring's XML namespaces
+ Code-based equivalents to popular Spring XML namespace elements such as
+ <tx:annotation-driven/> and <mvc:annotation-driven> have been
+ developed, in the form of @Enable annotations,
+ for use in conjunction with Spring's @Configuration
+ classes.
+
+
+ See org.springframework.scheduling.annotation.Configuration Javadoc
+
+
+ See org.springframework.scheduling.annotation.EnableAsync Javadoc
+
+
+ See org.springframework.scheduling.annotation.EnableScheduling
+ Javadoc
+ See
+ org.springframework.scheduling.annotation.EnableTransactionManagement
+ Javadoc
+
+
+ See org.springframework.scheduling.annotation.EnableWebMvc Javadoc
+
+
+
+
+ Builder-style APIs for code-based Hibernate configuration
+ SessionFactoryBuilder and
+ AnnotationSessionFactoryBuilder classes have been designed
+ for use within @Bean methods in
+ @Configuration classes.
+
+
+ See org.springframework.orm.hibernate3.SessionFactoryBuilder Javadoc
+
+
+ See
+ org.springframework.orm.hibernate3.annotation.AnnotationSessionFactoryBuilder
+ Javadoc
+
+
+
+
+ TestContext framework support for @Configuration classes
+ The @ContextConfiguration annotation now
+ supports supplying @Configuration classes for
+ configuring the Spring TestContext
+
+
+ See org.springframework.test.context.ContextConfiguration Javadoc
+
+
+
+
+ c: namespace for more concise constructor injection
+
+
+
+
+
+
+
+ Support for injection against non-standard JavaBeans setters
+ Prior to Spring 3.1, in order to inject against a property method it had to
+ conform strictly to JavaBeans property signature rules, namely that any 'setter'
+ method must be void-returning. It is now possible in Spring XML to specify
+ setter methods that return any object type. This is useful when considering
+ designing APIs for method-chaining, where setter methods return a reference to
+ 'this'.
+
+
+ Support for Servlet 3 code-based configuration of Servlet Container
+ The new WebApplicationInitializer builds atop
+ Servlet 3.0's ServletContainerInitializer support
+ to provide a programmatic alternative to the traditional web.xml.
+
+
+ See org.springframework.web.WebApplicationInitializer Javadoc
+
+
+ Diff from Spring's Greenhouse
+ reference application demonstrating migration from web.xml to
+ WebApplicationInitializer
+
+
+
+
+ Support for Servlet 3 MultipartResolver
+
+
+ See
+ org.springframework.web.multipart.support.StandardServletMultipartResolver
+ Javadoc
+
+
+
+
+
diff --git a/spring-framework-reference/src/spring-framework-reference.xml b/spring-framework-reference/src/spring-framework-reference.xml
index 9e4dbdabe77..09687c799d3 100644
--- a/spring-framework-reference/src/spring-framework-reference.xml
+++ b/spring-framework-reference/src/spring-framework-reference.xml
@@ -241,6 +241,7 @@
What's New in Spring 3
+