--- AnyEvent-HTTP/HTTP.pm	2018/08/30 17:04:28	1.131
+++ AnyEvent-HTTP/HTTP.pm	2018/09/01 03:16:43	1.133
@@ -344,8 +344,8 @@
 Try to create/reuse a persistent connection. When this flag is set
 (default: true for idempotent requests, false for all others), then
 C<http_request> tries to re-use an existing (previously-created)
-persistent connection to the host and, failing that, tries to create a new
-one.
+persistent connection to same host (i.e. identical URL scheme, hostname,
+port and session) and, failing that, tries to create a new one.
 
 Requests failing in certain ways will be automatically retried once, which
 is dangerous for non-idempotent requests, which is why it defaults to off
@@ -1311,7 +1311,7 @@
 chance of understanding the above paragraph:
 
    {
-      version    => 1,
+      version    => 2,
       "10.0.0.1" => {
          "/" => {
             "mythweb_id" => {