diff --git a/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/web/client/ClientHttpRequestFactories.java b/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/web/client/ClientHttpRequestFactories.java
index 9ce340b689..96e7b28056 100644
--- a/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/web/client/ClientHttpRequestFactories.java
+++ b/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/web/client/ClientHttpRequestFactories.java
@@ -61,8 +61,14 @@ public final class ClientHttpRequestFactories {
}
/**
- * Return a new {@link ClientHttpRequestFactory} instance using the most appropriate
- * implementation.
+ * Return a {@link ClientHttpRequestFactory} implementation with the given
+ * {@code settings} applied. The first of the following implementations whose
+ * dependencies {@link ClassUtils#isPresent are available} is returned:
+ *
+ * - {@link HttpComponentsClientHttpRequestFactory}
+ * - {@link OkHttp3ClientHttpRequestFactory}
+ * - {@link SimpleClientHttpRequestFactory}
+ *
* @param settings the settings to apply
* @return a new {@link ClientHttpRequestFactory}
*/
@@ -78,8 +84,17 @@ public final class ClientHttpRequestFactories {
}
/**
- * Return a new {@link ClientHttpRequestFactory} of the given type, applying
- * {@link ClientHttpRequestFactorySettings} using reflection if necessary.
+ * Return a new {@link ClientHttpRequestFactory} of the given
+ * {@code requestFactoryType}, applying {@link ClientHttpRequestFactorySettings} using
+ * reflection if necessary. The following implementations are supported without the
+ * use of reflection:
+ *
+ * - {@link HttpComponentsClientHttpRequestFactory}
+ * - {@link OkHttp3ClientHttpRequestFactory}
+ * - {@link SimpleClientHttpRequestFactory}
+ *
+ * A {@code requestFactoryType} of {@link ClientHttpRequestFactory} is equivalent to
+ * calling {@link #get(ClientHttpRequestFactorySettings)}.
* @param the {@link ClientHttpRequestFactory} type
* @param requestFactoryType the {@link ClientHttpRequestFactory} type
* @param settings the settings to apply