collectd.conf(5): Improve the "Redis plugin" documentation a bit.

diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod
index 4541870b4ad530e28de01000b8713876cc2d9f91..f16ebb1e46280a0f3e854936fac68d4bcc0729b8 100644 (file)
--- a/src/collectd.conf.pod
+++ b/src/collectd.conf.pod
@@ -3753,13 +3753,12 @@ Defaults to B<false>.
 
 =head2 Plugin C<redis>
 
-The C<redis> plugin connect to a list of redis servers and gather
-information about the server state. The C<redis> plugin support multiserver
-configuration, each server configuration block is called node and identify
-one redis instance (host and port).  Here is a configuration example code:
+The I<Redis plugin> connects to one or more Redis servers and gathers
+information about each server's state. For each server there is a I<Node> block
+which configures the connection parameters for this node.
 
   <Plugin redis>
-    <Node example>
+    <Node "example">
         Host "localhost"
         Port "6379"
         Timeout 2000
@@ -3770,26 +3769,27 @@ one redis instance (host and port).  Here is a configuration example code:
 
 =item B<Node> I<Nodename>
 
-The B<Node> block identify a new redis node, that is a new redis instance
-running in an specified host and port, the name for node is a canonical
-identifier which is used as plugin instance, it's limited to 64 characters
-length.
+The B<Node> block identifies a new Redis node, that is a new Redis instance
+running in an specified host and port. The name for node is a canonical
+identifier which is used as I<plugin instance>. It is limited to
+64E<nbsp>characters in length.
 
 =item B<Host> I<Hostname>
 
-The B<Host> option is the hostname or IP address (setting as string) where
-redis instance is running on.
+The B<Host> option is the hostname or IP-address where the Redis instance is
+running on.
 
 =item B<Port> I<Port>
 
-The B<Port> option is the TCP port where redis instance in IP address or
-hostname setted in B<Host> option is running.
+The B<Port> option is the TCP port on which the Redis instance accepts
+connections. Either a service name of a port number may be given. Please note
+that numerical port numbers must be given as a string, too.
 
 =item B<Timeout> I<Timeout in miliseconds>
 
-The B<Timeout> option set the socket timeout for node response. Since the
-redis read function is blocking, you may keep this value as low as possible.
-Keep in mind that the sum of all Timeout values for all Nodes might be lower
+The B<Timeout> option set the socket timeout for node response. Since the Redis
+read function is blocking, you should keep this value as low as possible. Keep
+in mind that the sum of all B<Timeout> values for all B<Nodes> should be lower
 than B<Interval> defined globally.
 
 =back