From: Michael Albinus <michael.albinus@gmx.de>
Date: Sun, 3 Nov 2024 14:48:19 +0000 (+0100)
Subject: Improve Tramp documentation on direct async processes
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=823bbb609f800e7771a7c0a71ae343e526d3d8aa;p=emacs.git

Improve Tramp documentation on direct async processes

* doc/misc/tramp.texi (Remote processes): Add another example
enabling direct async processes based on method name.  (Bug#74105)

* etc/NEWS: Rephrase Tramp entry on direct async processes.

(cherry picked from commit 03fa832b4dcc47276894d90f3323bca31eb0633e)
---

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index bb2a7313533..164cb60fe69 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -4607,6 +4607,18 @@ which must be set to a non-@code{nil} value.  Example:
 @end group
 @end lisp
 
+This enables direct async processes for the host @samp{remotehost}.
+If you want to enable direct async processes for all remote hosts
+connected via the same method (e.g., @option{ssh}), use instead
+
+@lisp
+@group
+(connection-local-set-profiles
+ '(:application tramp :protocol "ssh")
+ 'remote-direct-async-process)
+@end group
+@end lisp
+
 Using direct asynchronous processes in @value{tramp} is not possible,
 if the remote host is connected via multiple hops
 (@pxref{Multi-hops}).  In this case, @value{tramp} falls back to its