[Emacs-diffs] master 792dc36: Precise documentation of Tramp ad-hoc proxies

[Michael Albinus]

branch: master
commit 792dc36e691b1e4b7735c75d2d402d1b9a8801ce
Author: Michael Albinus <address@hidden>
Commit: Michael Albinus <address@hidden>

    Precise documentation of Tramp ad-hoc proxies
    
    * doc/misc/tramp.texi (Ad-hoc multi-hops): Remove superfluous
    first entry about %h and %u.  Describe, how to remove ad-hoc proxy
    definitions.
    (Cleanup remote connections): Mention, that also ad-hoc proxy
    definitions are removed.
    
    * etc/NEWS: Mention default host names in Tramp ad-hoc proxies.
---
 doc/misc/tramp.texi | 21 ++++++++++++---------
 etc/NEWS            |  3 ++-
 2 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index c9f1e75..49c684f 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -2778,13 +2778,14 @@ proxy @samp{bird@@bastion} to a remote file on 
@samp{you@@remotehost}:
 
 Each involved method must be an inline method (@pxref{Inline methods}).
 
-Proxies can take patterns @code{%h} or @code{%u}.
-
 @value{tramp} adds the ad-hoc definitions on the fly to
address@hidden and is available for re-use
-during that Emacs session.  Subsequent @value{tramp} connections to
-the same remote host can then use the shortcut form:
address@hidden@trampfn{ssh,you@@remotehost,/path}}.
address@hidden and is available for re-use during
+that Emacs session.  Subsequent @value{tramp} connections to the same
+remote host can then use the shortcut form:
address@hidden@trampfn{ssh,you@@remotehost,/path}}.  Ad-hoc definitions are
+removed from @code{tramp-default-proxies-alist} via the command
address@hidden tramp-cleanup-all-connections @key{RET}} (@pxref{Cleanup
+remote connections}).
 
 @defopt tramp-save-ad-hoc-proxies
 For ad-hoc definitions to be saved automatically in
@@ -3175,13 +3176,15 @@ as in @code{tramp-cleanup-connection}.
 
 @deffn Command tramp-cleanup-all-connections
 Flushes all active remote connection objects, the same as in
address@hidden
address@hidden  This command removes also ad-hoc
+proxy definitions (@pxref{Ad-hoc multi-hops}).
+
 @end deffn
 
 @deffn Command tramp-cleanup-all-buffers
 Just as for @code{tramp-cleanup-all-connections}, all remote
-connections are cleaned up in addition to killing buffers related to
-that remote connection.
+connections and ad-hoc proxy definition are cleaned up in addition to
+killing buffers related to that remote connection.
 @end deffn
 
 
diff --git a/etc/NEWS b/etc/NEWS
index e427e84..fc8203e 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -910,7 +910,8 @@ Tramp for some look-alike remote file names.
 
 +++
 *** For some connection methods, like "su" or "sudo", the host name in
-ad-hoc multi-hop file names must match the previous hop.
+ad-hoc multi-hop file names must match the previous hop.  Default host
+names are adjusted to the host name from the previous hop.
 
 +++
 *** For the connection methods "sudo" and "doas" there exists a