Re: [PATCH] Provide completion candidates for remote containers over a TRAMP connection
Gene Goykhman <[email protected]>
| Newsgroups | gmane.emacs.tramp |
|---|---|
| Message-ID | <[email protected]> |
Hi Michael, Here is my proposed patch (against Emacs master) for adding documentation for `tramp-completion-multi-hop-methods' to tramp.texi and also announcing the update in etc/NEWS. Please feel free to edit as you see fit or I'm happy to make any additional changes.
0001-Document-and-announce-new-user-option-tramp-completi.patch
(text/x-patch, 1.8 KB)
From 164de20059e5bbdcb8c67c6c9644bd6d533eefaa Mon Sep 17 00:00:00 2001 From: Gene Goykhman <[email protected]> Date: Sun, 3 Sep 2023 11:39:29 -0400 Subject: [PATCH] Document and announce new user option `tramp-completion-multi-hop-methods' --- doc/misc/tramp.texi | 10 ++++++++++ etc/NEWS | 7 +++++++ 2 files changed, 17 insertions(+) diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 6189ef2d41d..b7661175986 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi @@ -3704,6 +3704,16 @@ host name of the previous hop is reused. Therefore, the following file name is equivalent to the previous example: @samp{@trampfn{ssh@value{postfixhop}remotehost|su,,}}. +@defopt tramp-completion-multi-hop-methods +When this list includes the last method in a multi-hop connection, +the remote host will be queried for a list of completion candidates. +This can, for example, provide a list of running remote docker or +podman containers on the remote host. + +@lisp +(customize-set-variable 'tramp-completion-multi-hop-methods `(,tramp-docker-method ,tramp-podman-method)) +@end lisp +@end defopt @node Home directories @section Expanding @file{~} to home directory diff --git a/etc/NEWS b/etc/NEWS index 9a98db8c83a..2b69829e910 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -453,6 +453,13 @@ This macro could wrap code which handles local files only. Due to the temporary deactivation of remote files, it results in a slightly improved performance of file name handling in Emacs. ++++ +*** New user option 'tramp-completion-multi-hop-methods'. +Contains a list of connection methods for which completion should be +attempted at the end of a multi-hop chain. Allows completion +candidates to include a list of, for example, containers running +on a remote docker host. + ** EWW +++ -- 2.39.2 (Apple Git-143)