diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index e1130917f0c..69572a139ff 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -4580,6 +4580,11 @@ It does not report the remote terminal name via @code{process-tty-name}.
 
 @item
 It does not set process property @code{remote-pid}.
+
+@item
+It fails, when the command is too long.  This can happen on
+directories with a long directory name, or when the remote @env{PATH}
+and/or other environment variables, which must be set, are too long.
 @end itemize
 
 In order to gain even more performance, it is recommended to bind