feat[redis cache plugin]: Add Redis connection parameters full contro…

…l support

plugins/cache/redis.py

@@ -17,15 +17,15 @@
     options:
       _uri:
         description:
-          - Simple format:
-            - A colon separated string of connection information for Redis.
-            - The format is V(host:port:db:password), for example V(localhost:6379:0:changeme).
-            - To use encryption in transit, prefix the connection with V(tls://), as in V(tls://localhost:6379:0:changeme).
-            - To use redis sentinel, use separator V(;), for example V(localhost:26379;localhost:26379;0:changeme). Requires redis>=2.9.0.
-          - Full connection control format:
-            - Redis socket connection parameters as <name>=<value> pairs '&' separated.
-            - Example: V(host=localhost&port=6379&db=0&password=changeme&socket_keepalive=true).
-            - See https://redis-py2.readthedocs.io/en/latest/ for Redis connection parameters name and accepted values.
+          - Redis connection string, 3 possible formats.
+          - The simple format consist in a colon separated string of connection information for Redis.
+          - This first format is V(host:port:db:password), for example V(localhost:6379:0:changeme).
+          - To use encryption in transit, prefix the connection with V(tls://), as in V(tls://localhost:6379:0:changeme).
+          - To use redis sentinel, use second format with separator V(;), for example V(localhost:26379;localhost:26379;0:changeme). Requires redis>=2.9.0.
+          - To specify advanced connection parameters (keep alive, etc ...), use the 3rd format.
+          - This last format consists in a '&' separated string of redis connection parameters as <name>=<value> pairs.
+          - For example V(host=localhost&port=6379&db=0&password=changeme&socket_keepalive=true).
+          - See https://redis-py2.readthedocs.io/en/latest/ for Redis connection parameters name and accepted values.
         required: true
         env:
           - name: ANSIBLE_CACHE_PLUGIN_CONNECTION