diff --git a/modules/http_client/README b/modules/http_client/README
index 9384f35a984..48445cb6535 100644
--- a/modules/http_client/README
+++ b/modules/http_client/README
@@ -442,6 +442,13 @@ modparam("http_client", "authmetod", 3)
    call. The address given in the function call will be appended to the
    base URL in the connection definition.
 
+   The HTTP connection will be defined using default values in modparam's
+   above the definition of the httpcon in the configuration file. Also
+   note that connections can be defined in a separate text file if you
+   have many parameters per connection, or want to use a per-connection
+   setting that can be set in that file but not in the httpcon modparam,
+   like authmethod.
+
    By default, no connections are defined.
 
    Parameters
diff --git a/modules/http_client/doc/http_client_admin.xml b/modules/http_client/doc/http_client_admin.xml
index 924830fd34f..b39e36ec5ae 100644
--- a/modules/http_client/doc/http_client_admin.xml
+++ b/modules/http_client/doc/http_client_admin.xml
@@ -417,6 +417,12 @@ modparam("http_client", "authmetod", 3)
 			address given in the function call will be appended to the base URL in the connection definition.
 			</para>
 			<para>
+			The HTTP connection will be defined using default values in modparam's above the definition
+			of the httpcon in the configuration file. Also note that connections can be defined in a
+			separate text file if you have many parameters per connection, or want to use a per-connection
+			setting that can be set in that file but not in the httpcon modparam, like authmethod.
+			</para>
+			<para>
 			<emphasis>
 				By default, no connections are defined.
 			</emphasis>