diff --git a/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/context/properties/ConfigurationPropertiesBindHandlerAdvisor.java b/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/context/properties/ConfigurationPropertiesBindHandlerAdvisor.java
index a125df5b30e..8a9d409bbe8 100644
--- a/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/context/properties/ConfigurationPropertiesBindHandlerAdvisor.java
+++ b/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/context/properties/ConfigurationPropertiesBindHandlerAdvisor.java
@@ -33,7 +33,7 @@ public interface ConfigurationPropertiesBindHandlerAdvisor {
 	/**
 	 * Apply additional functionality to the source bind handler.
 	 * @param bindHandler the source bind handler
-	 * @return a replacement bind hander that delegates to the source and provides
+	 * @return a replacement bind handler that delegates to the source and provides
 	 * additional functionality
 	 */
 	BindHandler apply(BindHandler bindHandler);
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 525442626f5..3914be6d0e4 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
@@ -41,7 +41,7 @@ public interface BindHandler {
 	 * @param name the name of the element being bound
 	 * @param target the item being bound
 	 * @param context the bind context
-	 * @return {@code true} if binding should proceed
+	 * @return the actual item that should be used for binding (may be {@code null})
 	 */
 	default <T> Bindable<T> onStart(ConfigurationPropertyName name, Bindable<T> target,
 			BindContext context) {