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.
>From 164de20059e5bbdcb8c67c6c9644bd6d533eefaa Mon Sep 17 00:00:00 2001
From: Gene Goykhman <g...@indigo1.com>
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)
