From 1bfcdd2c2a84ac37a76df08953df55bd065da44b Mon Sep 17 00:00:00 2001
From: Gunnar Morling <gunnar.morling@googlemail.com>
Date: Tue, 25 Nov 2014 22:31:53 +0100
Subject: [PATCH] #295 Improving comment

---
 .../java/org/mapstruct/NullValueMappingStrategy.java   | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/core-common/src/main/java/org/mapstruct/NullValueMappingStrategy.java b/core-common/src/main/java/org/mapstruct/NullValueMappingStrategy.java
index 1aa7ca5c4..7000c7e86 100644
--- a/core-common/src/main/java/org/mapstruct/NullValueMappingStrategy.java
+++ b/core-common/src/main/java/org/mapstruct/NullValueMappingStrategy.java
@@ -35,10 +35,12 @@ public enum NullValueMappingStrategy {
      * If {@code null} is passed to a mapping method, a default value will be returned. The value depends on the kind of
      * the annotated method:
      * <ul>
-     * <li>For bean mapping method the target type will be instantiated and returned. {@link Mapping#expression()} and
-     * {@link Mapping#constant()} will be added to the target</li>
-     * <li>For iterable mapping methods an immutable empty collection will be returned.</li>
-     * <li>For map mapping methods an immutable empty map will be returned.</li>
+     * <li>For bean mapping methods the target type will be instantiated and returned. Any properties of the target type
+     * which are mapped via {@link Mapping#expression()} or {@link Mapping#constant()} will be populated based on the
+     * given expression or constant. Note that expressions must be prepared to deal with {@code null} values in this
+     * case.</li>
+     * <li>For iterable mapping methods an empty collection will be returned.</li>
+     * <li>For map mapping methods an empty map will be returned.</li>
      * </ul>
      */
     RETURN_DEFAULT,