diff --git a/org.springframework.beans/src/main/java/org/springframework/beans/factory/config/BeanPostProcessor.java b/org.springframework.beans/src/main/java/org/springframework/beans/factory/config/BeanPostProcessor.java
index 180bede10e..ee23681759 100644
--- a/org.springframework.beans/src/main/java/org/springframework/beans/factory/config/BeanPostProcessor.java
+++ b/org.springframework.beans/src/main/java/org/springframework/beans/factory/config/BeanPostProcessor.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2007 the original author or authors.
+ * Copyright 2002-2010 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
@@ -48,7 +48,8 @@ public interface BeanPostProcessor {
* The returned bean instance may be a wrapper around the original.
* @param bean the new bean instance
* @param beanName the name of the bean
- * @return the bean instance to use, either the original or a wrapped one
+ * @return the bean instance to use, either the original or a wrapped one; if
+ * null
, no subsequent BeanPostProcessors will be invoked
* @throws org.springframework.beans.BeansException in case of errors
* @see org.springframework.beans.factory.InitializingBean#afterPropertiesSet
*/
@@ -68,7 +69,8 @@ public interface BeanPostProcessor {
* in contrast to all other BeanPostProcessor callbacks.
* @param bean the new bean instance
* @param beanName the name of the bean
- * @return the bean instance to use, either the original or a wrapped one
+ * @return the bean instance to use, either the original or a wrapped one; if
+ * null
, no subsequent BeanPostProcessors will be invoked
* @throws org.springframework.beans.BeansException in case of errors
* @see org.springframework.beans.factory.InitializingBean#afterPropertiesSet
* @see org.springframework.beans.factory.FactoryBean