Add CAVEATS section to cdist man page.

docs/src/man1/cdist.rst

@@ -220,6 +220,18 @@ AUTHORS
 -------
 Nico Schottelius <nico-cdist--@--schottelius.org>
 
+CAVEATS
+-------
+When operating in parallel, either by operating in parallel for each host
+(-p/--parallel) or by parallel jobs within a host (-j/--jobs), and depending
+on target SSH server and its configuration you may encounter connection drops.
+This is controlled with sshd :strong:`MaxStartups` configuration options.
+You may also encounter session open refusal. This happens with ssh multiplexing
+when you reach maximum number of open sessions permitted per network
+connection. In this case ssh will disable multiplexing.
+This limit is controlled with sshd :strong:`MaxSessions` configuration
+options. For more details refer to :strong:`sshd_config`\ (5).
+
 COPYING
 -------
 Copyright \(C) 2011-2013 Nico Schottelius. Free use of this software is