From: Michael Albinus <michael.albinus@gmx.de>
Date: Sun, 22 Dec 2024 08:30:47 +0000 (+0100)
Subject: Improve D-Bus and Tramp manual
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=45e816e7799ed5f40a6f5b12e7ab2471498991b5;p=emacs.git

Improve D-Bus and Tramp manual

* doc/misc/dbus.texi (Overview):
* doc/misc/tramp.texi (GVFS-based methods): Describe, how the
feature can be checked at runtime.  (Bug#75004)

(cherry picked from commit e281355a5e88771b66afe35f425ce09064ef5147)
---

diff --git a/doc/misc/dbus.texi b/doc/misc/dbus.texi
index 42fe07367b8..e852d64b71d 100644
--- a/doc/misc/dbus.texi
+++ b/doc/misc/dbus.texi
@@ -75,9 +75,12 @@ another.  An overview of D-Bus can be found at
 @cindex overview
 
 D-Bus is an inter-process communication mechanism for applications
-residing on the same host.  The communication is based on
-@dfn{messages}.  Data in the messages is carried in a structured way,
-it is not just a byte stream.
+residing on the same host.  Emacs uses it when it is compiled with the
+respective library, see configuration option @option{--with-dbus}.  At
+runtime, the form @code{(featurep 'dbusbind)} indicates D-Bus support.
+
+D-Bus communication is based on @dfn{messages}.  Data in the messages is
+carried in a structured way, it is not just a byte stream.
 
 The communication is connection oriented to two kinds of message
 buses: a so called @dfn{system bus}, and a @dfn{session bus}.  On a
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 86a7bf4c0eb..fe908e6026a 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -1397,9 +1397,12 @@ Desktop, @uref{https://en.wikipedia.org/wiki/GVFS}.  Remote files on
 @acronym{GVFS} are mounted locally through @acronym{FUSE} and
 @value{tramp} uses this locally mounted directory internally.
 
-Emacs uses the D-Bus mechanism to communicate with @acronym{GVFS}@.
-Emacs must have the message bus system, D-Bus integration active,
-@pxref{Top, , D-Bus, dbus}.
+Emacs uses the D-Bus mechanism to communicate with @acronym{GVFS}@.  It
+must have been compiled with D-Bus support, @pxref{Top, , D-Bus, dbus}.
+
+@vindex tramp-gvfs-enabled
+The @code{tramp-gvfs-enabled} variable, being non-@code{nil}, signals
+that @value{tramp} can use @acronym{GVFS}-based methods.
 
 @table @asis
 @cindex method @option{afp}