diff --git a/docs/src/reference/docbook/transformer.xml b/docs/src/reference/docbook/transformer.xml
index 18d472daf0..f55924f6ac 100644
--- a/docs/src/reference/docbook/transformer.xml
+++ b/docs/src/reference/docbook/transformer.xml
@@ -67,13 +67,13 @@
Message (the keys must be Strings).
- Since Spring Integration 2.0 after many debates we've changed the behavior of Message Transformer for the cases where
- transformation method returns null. Returning null will now result in the exception. In other
- words Message Transformer should no longer be used as Message Filter (that is what Message Filter is for). Message Transformer
- should always be expected to transform the source Message into a valid target Message.
- However, if you still need this type of behavior (where component might return NULL and not be considered an error), a
- service-activator could be used. Its requires-reply value is FALSE by default, but can
- be set to TRUE in order to have Exceptions thrown for NULL return values.
+ As of Spring Integration 2.0, a Message Transformer's transformation method can no longer return null.
+ Returning null will result in an exception since a Message Transformer should always be expected to
+ transform each source Message into a valid target Message. In other words, a Message Transformer should not be used
+ as a Message Filter since there is a dedicated <filter> option for that. However, if you do need this type of
+ behavior (where a component might return NULL and that should not be considered an error), a
+ service-activator could be used. Its requires-reply value is FALSE by default,
+ but that can be set to TRUE in order to have Exceptions thrown for NULL return values as with the transformer.