[Emacs-diffs] emacs/doc/misc tramp.texi

[Michael Albinus]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Michael Albinus <albinus>       09/06/22 21:39:28

Modified files:
        doc/misc       : tramp.texi 

Log message:
        * tramp.texi (History): Add GVFS support.
        (External methods): Precise `rsync' description.  Add `dav', `davs' and
        `obex' methods.  Add 'tramp-gvfs-methods' option.
        (Multi-hops): Cells of `tramp-default-proxies-alist' can also be Lisp
        forms.
        (Remote Programs): Introduce `tramp-own-remote-path'.
        (Remote processes): New subsection "Running remote programs that create
        local X11 windows".
        (Frequently Asked Questions): Improve code for disabling vc.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/tramp.texi?cvsroot=emacs&r1=1.25&r2=1.26

Patches:
Index: tramp.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/tramp.texi,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- tramp.texi  16 Feb 2009 17:42:04 -0000      1.25
+++ tramp.texi  22 Jun 2009 21:39:28 -0000      1.26
@@ -464,6 +464,9 @@
 @ifset emacsgw
 Support of gateways exists since April 2007.
 @end ifset
address@hidden emacsgvfs
+GVFS integration started in February 2009.
address@hidden ifset
 
 In December 2001, @value{tramp} has been added to the XEmacs package
 repository.  Being part of the GNU Emacs repository happened in June
@@ -854,11 +857,11 @@
 
 While @command{rsync} performs much better than @command{scp} when
 transferring files that exist on both hosts, this advantage is lost if
-the file exists only on one side of the connection.
-
-The @command{rsync} based method may be considerably faster than the
address@hidden based methods when writing to the remote system.  Reading
-files to the local machine is no faster than with a direct copy.
+the file exists only on one side of the connection.  A file can exists
+on both the remote and local host, when you copy a file from/to a
+remote host.  When you just open a file from the remote host (or write
+a file there), this is not the case, because on the local side
+temporary files are used.
 
 This method supports the @samp{-p} hack.
 
@@ -1025,8 +1028,45 @@
 disadvantage is that there's no possibility to specify another user
 name.
 
address@hidden emacsgvfs
address@hidden @option{dav}
address@hidden method dav
address@hidden dav method
+
+This method provides access to WebDAV files and directories.  It is
+available on systems only which run GVFS
address@hidden://en.wikipedia.org/wiki/GVFS}.  Via GVFS, the remote
+filesystem is mounted locally through FUSE.  @value{tramp} uses
+internally this local mounted directory.
+
+The communication with GVFS is implemented via D-Bus messages.
+Therefore, your @value{emacsname} must have D-Bus integration.
+
+There exists also the external method @option{davs}, which uses SSL
+encryption for the access.
+
+Both methods support the port number specification as discussed above.
+
address@hidden @option{obex}
address@hidden method obex
address@hidden obex method
+
+OBEX is an FTP-like access protocol for simple devices, like cell
+phones.  Like @option{dav} and @option{davs}, it uses GVFS for
+mounting remote files and directories via FUSE.  Until now
address@hidden supports only OBEX over Bluetooth.
address@hidden ifset
 @end table
 
address@hidden emacsgvfs
address@hidden tramp-gvfs-methods
+This customer option, a list, defines the external methods, which
+shall be used with GVFS.  Per default, these are @option{dav},
address@hidden and @option{obex}.  Other possible values are
address@hidden, @option{sftp} and @option{smb}.
address@hidden defopt
address@hidden ifset
+
 
 @ifset emacsgw
 @node Gateway methods
@@ -1346,6 +1386,19 @@
 has been reached so far.  @code{sudo -u root}, applied on your local
 host, wouldn't be useful here.
 
address@hidden, @var{user} and @var{proxy} can also be Lisp forms.  These
+forms are evaluated, and must return a string, or @code{nil}.  The
+previous example could be generalized then: For all hosts except my
+local one connect via @code{ssh} first, and apply @code{sudo -u root}
+afterwards:
+
address@hidden
+(add-to-list 'tramp-default-proxies-alist
+             '(nil "\\`root\\'" "@trampfn{ssh, , %h,}"))
+(add-to-list 'tramp-default-proxies-alist
+             '((regexp-quote (system-name)) nil nil))
address@hidden lisp
+
 This is the recommended configuration to work as @samp{root} on remote
 Ubuntu hosts.
 
@@ -1640,6 +1693,9 @@
 remote file access.
 
 @vindex tramp-remote-path
address@hidden tramp-default-remote-path
address@hidden tramp-own-remote-path
address@hidden tramp-remote-path
 When @value{tramp} connects to the remote machine, it searches for the
 programs that it can use.  The variable @code{tramp-remote-path}
 controls the directories searched on the remote machine.
@@ -1671,6 +1727,17 @@
 (add-to-list 'tramp-remote-path "/usr/local/perl/bin")
 @end lisp
 
+Another possibility is to reuse the path settings of your remote
+account, when you log in.  Usually, these settings are overwritten,
+because they might not be useful for @value{tramp}.  The place holder
address@hidden preserves these settings.  You can
+activate it via
+
address@hidden
+(add-to-list 'tramp-remote-path 'tramp-own-remote-path)
address@hidden lisp
address@hidden defopt
+
 @value{tramp} caches several information, like the Perl binary
 location.  The changed remote search path wouldn't affect these
 settings.  In order to force @value{tramp} to recompute these values,
@@ -2379,6 +2446,28 @@
 integrate them as well.  @xref{Bug Reports}.
 
 
address@hidden Running remote programs that create local X11 windows
+
+If you want to run a remote program, which shall connect the X11
+server you are using with your local host, you can set the
address@hidden environment variable on the remote host:
+
address@hidden
+(add-to-list 'tramp-remote-process-environment
+             (format "DISPLAY=%s" (getenv "DISPLAY")))
address@hidden lisp
+
address@hidden
address@hidden(getenv "DISPLAY")} shall return a string containing a host
+name, which can be interpreted on the remote host; otherwise you might
+use a fixed host name.  Strings like @code{:0} cannot be used properly
+on the remote host.
+
+Another trick might be that you put @code{ForwardX11 yes} or
address@hidden yes} to your @file{~/.ssh/config} file for
+that host.
+
+
 @subsection Running shell-command on a remote host
 @cindex shell-command
 
@@ -2598,7 +2687,10 @@
 disabling VC.  This can be achieved by
 
 @lisp
-(setq vc-handled-backends nil)
+(setq vc-ignore-dir-regexp
+      (format "\\(%s\\)\\|\\(%s\\)"
+              vc-ignore-dir-regexp
+              tramp-file-name-regexp))
 @end lisp
 
 Disable excessive traces.  The default trace level of @value{tramp},