* tramp.texi (Frequently Asked Questions): New item for

ControlPath settings.

diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 285097c..a5b2edb 100644 (file)
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,8 @@
+2013-04-15  Michael Albinus  <michael.albinus@gmx.de>
+
+       * tramp.texi (Frequently Asked Questions): New item for
+       ControlPath settings.
+
 2013-03-31  Jay Belanger  <jay.p.belanger@gmail.com>
 
        * calc.texi: (Basic Operations on Units): Streamline some

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 4837b44..42a3156 100644 (file)
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -3123,6 +3123,23 @@ Host *
 @end example
 
 
+@item
+@value{tramp} does not use my @command{ssh} @code{ControlPath}
+
+Your @code{ControlPath} setting will be overwritten by @command{ssh}
+sessions initiated by @value{tramp}.  This is because a master
+session, initiated outside @value{emacsname}, could be closed, which
+would stall all other @command{ssh} sessions for that host inside
+@value{emacsname}.
+
+Consequently, if you connect to a remote host via @value{tramp}, you
+might be prompted for a password again, even if you have established
+already an @command{ssh} connection to that host.  Further
+@value{tramp} connections to that host, for example in order to run a
+process on that host, will reuse that initial @command{ssh}
+connection.
+
+
 @item
 File name completion does not work with @value{tramp}