diff --git a/docs/asciidoc/http-client-conn-provider.adoc b/docs/asciidoc/http-client-conn-provider.adoc index 8246d8f197..28f5938e2e 100644 --- a/docs/asciidoc/http-client-conn-provider.adoc +++ b/docs/asciidoc/http-client-conn-provider.adoc @@ -39,8 +39,8 @@ The following listing shows the available configurations: |======= | Configuration name | Description | `disposeInactivePoolsInBackground` | When this option is enabled, connection pools are regularly checked in the background, -and those that are empty and been inactive for a specified time become eligible for disposal. By default, this background -disposal of inactive pools is disabled. +and those that are *empty* and been inactive for a specified time become eligible for disposal. Connection pool is considered +*empty* when there are no active connections, idle connections and pending acquisitions. By default, this background disposal of inactive pools is disabled. | `disposeTimeout` | When `ConnectionProvider#dispose()` or `ConnectionProvider#disposeLater()` is called, trigger a graceful shutdown for the connection pools, with this grace period timeout. From there on, all calls for acquiring a connection will fail fast with an exception. diff --git a/reactor-netty-core/src/main/java/reactor/netty/resources/ConnectionProvider.java b/reactor-netty-core/src/main/java/reactor/netty/resources/ConnectionProvider.java index d1a50795ef..0f3fc43b93 100644 --- a/reactor-netty-core/src/main/java/reactor/netty/resources/ConnectionProvider.java +++ b/reactor-netty-core/src/main/java/reactor/netty/resources/ConnectionProvider.java @@ -435,8 +435,9 @@ public final Builder name(String name) { /** * Set the options to use for configuring {@link ConnectionProvider} background disposal for inactive connection pools. - * When this option is enabled, the connection pools are regularly checked whether they are empty and inactive - * for a specified time, thus applicable for disposal. + * When this option is enabled, the connection pools are regularly checked whether they are empty and inactive + * for a specified time, thus applicable for disposal. Connection pool is considered + * empty when there are no active connections, idle connections and pending acquisitions. * Default to {@link #DISPOSE_INACTIVE_POOLS_IN_BACKGROUND_DISABLED} - the background disposal is disabled. * Providing a {@code disposeInterval} of {@link Duration#ZERO zero} means the background disposal is disabled. *