Notice IPv6 address [] notation.

docs/src/cdist-remote-exec-copy.rst

@@ -17,6 +17,11 @@ passing them to cdist with the --remote-exec and/or --remote-copy arguments.
 
 For __remote_exec, the custom implementation must behave as if it where ssh.
 For __remote_copy, it must behave like scp.
+Please notice, custom implementations should work like ssh/scp so __remote_copy
+must support IPv6 addresses enclosed in square brackets. For __remote_exec you
+must take into account that for some options (like -L) IPv6 addresses can be
+specified by enclosed in square brackets (see :strong:`ssh`\ (1) and
+:strong:`scp`\ (1)).
 
 With this simple interface the user can take total control of how cdist
 interacts with the target when required, while the default implementation 

docs/src/cdist-type.rst

@@ -251,6 +251,12 @@ script, you can write to stderr:
     # Output to be saved by cdist for execution on the target
     echo "touch /etc/cdist-configured"
 
+Notice: if you use __remote_copy or __remote_exec directly in your scripts
+then for IPv6 address with __remote_copy execution you should enclose IPv6
+address in square brackets. The same applies to __remote_exec if it behaves
+the same as ssh for some options where colon is a delimiter, as for -L ssh
+option (see :strong:`ssh`\ (1) and :strong:`scp`\ (1)).
+
 
 Variable access from the generated scripts
 ------------------------------------------

docs/src/man1/cdist.rst

@@ -157,6 +157,12 @@ cdist/conf
     The distribution configuration directory. It contains official types and
     explorers. This path is relative to cdist installation directory.
 
+NOTES
+-----
+cdist detects if host is specified by IPv6 address. If so then remote_copy
+command is executed with host address enclosed in square brackets 
+(see :strong:`scp`\ (1)).
+
 EXAMPLES
 --------