]> git.eshelyaron.com Git - emacs.git/commitdiff
Improve D-Bus and Tramp manual
authorMichael Albinus <michael.albinus@gmx.de>
Sun, 22 Dec 2024 08:30:47 +0000 (09:30 +0100)
committerEshel Yaron <me@eshelyaron.com>
Sat, 4 Jan 2025 18:04:52 +0000 (19:04 +0100)
* 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)

doc/misc/dbus.texi
doc/misc/tramp.texi

index 42fe07367b841f747ff92a109e6ab8a1e9bbb893..e852d64b71d8d7ac986e204dd3079154d1c3c549 100644 (file)
@@ -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
index 86a7bf4c0ebe19d7d1e8572a2a1e46e6828c8927..fe908e6026a8d76cb60d39ac1ee83cc3dac806c6 100644 (file)
@@ -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}