diff --git a/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/context/properties/bind/BindHandler.java b/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/context/properties/bind/BindHandler.java
index 1e21ca2ad6..5059f4dee1 100644
--- a/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/context/properties/bind/BindHandler.java
+++ b/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/context/properties/bind/BindHandler.java
@@ -77,7 +77,9 @@ public interface BindHandler {
 	}
 
 	/**
-	 * Called when binding finishes, regardless of whether the property was bound or not.
+	 * Called when binding finishes with either bound or unbound result. This method will
+	 * not be called when binding failed, even if a handler rurns a result from
+	 * {@link #onFailure}.
 	 * @param name the name of the element being bound
 	 * @param target the item being bound
 	 * @param context the bind context