From: Michael Albinus <michael.albinus@gmx.de>
Date: Sun, 22 Dec 2019 12:47:29 +0000 (+0100)
Subject: Add item to Frequently Asked Questions of Tramp manual
X-Git-Tag: emacs-27.0.90~315
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7c79d170436e5ea97de45e4d05a5230754e24bef;p=emacs.git

Add item to Frequently Asked Questions of Tramp manual

* doc/misc/tramp.texi (Frequently Asked Questions): Add item for
ControlMaster option on proxy hosts.  Explain changing syntax to
Ange FTP.
---

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index dd1378a8da7..f3951cf110a 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -4082,6 +4082,31 @@ this @code{nil} setting:
 @end lisp
 
 
+@item
+On multi-hop connections, @value{tramp} does not use @command{ssh}
+@code{ControlMaster}
+
+In order to use the @code{ControlMaster} option, @value{tramp} must
+check whether the @command{ssh} client supports this option.  This is
+only possible on the local host, for the first hop.  @value{tramp}
+does not use this option on proxy hosts.
+
+If you want to use this option also for the other hops, you must
+configure @file{~/.ssh/config} on the proxy host:
+
+@example
+@group
+Host *
+     ControlMaster	auto
+     ControlPath	tramp.%C
+     ControlPersist	no
+@end group
+@end example
+
+Check @command{man ssh_config} whether these options are supported on
+your proxy host.
+
+
 @item
 File name completion does not work with @value{tramp}
 
@@ -4606,6 +4631,12 @@ in @file{.emacs}:
 (customize-set-variable 'tramp-default-method "ftp")
 @end lisp
 
+If you want to enable Ange FTP's syntax, add the following form:
+
+@lisp
+(tramp-change-syntax 'simplified)
+@end lisp
+
 @item
 @vindex tramp-mode
 To disable both @value{tramp} (and Ange FTP), set @code{tramp-mode} to