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

[Michael Albinus]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Michael Albinus <albinus>       09/09/28 14:26:45

Modified files:
        doc/misc       : tramp.texi 

Log message:
        * tramp.texi (History): Add IMAP support.
        (External methods): Add `imap' and `imaps' methods.
        (GVFS based methods): Add indices for `davs'.
        (Password handling): Rename anchors.  Add IMAP entries for
        ~/.authinfo.gpg.

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

Patches:
Index: tramp.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/tramp.texi,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -b -r1.31 -r1.32
--- tramp.texi  3 Sep 2009 15:21:47 -0000       1.31
+++ tramp.texi  28 Sep 2009 14:26:45 -0000      1.32
@@ -440,17 +440,19 @@
 many more methods for getting a remote shell and for transferring the
 file contents were added.  Support for VC was added.
 
-The most recent addition of major features were the multi-hop methods
-added in April 2000 and the unification of @value{tramp} and Ange-FTP
-filenames in July 2002.  In July 2004, multi-hop methods have been
-replaced by proxy hosts.  Running commands on remote hosts was
-introduced in December 2005.
+After that, there were added the multi-hop methods in April 2000 and
+the unification of @value{tramp} and Ange-FTP filenames in July 2002.
+In July 2004, multi-hop methods have been replaced by proxy hosts.
+Running commands on remote hosts was introduced in December 2005.
 @ifset emacsgw
 Support of gateways exists since April 2007.
 @end ifset
 @ifset emacsgvfs
 GVFS integration started in February 2009.
 @end ifset
address@hidden emacsimap
+Storing files into IMAP mailboxes has been added in September 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
@@ -1028,6 +1030,29 @@
 file names like @file{//melancholia/daniel$$/.emacs}.  The only
 disadvantage is that there's no possibility to specify another user
 name.
+
+
address@hidden emacsimap
address@hidden @option{imap}
address@hidden method imap
address@hidden method imaps
address@hidden imap method
address@hidden imaps method
+
+Accessing an IMAP mailbox is intended to save files there as encrypted
+message.  It could be used in case there are no other remote file
+storages available.
+
address@hidden supports both @option{imap} and @option{imaps} methods.
+The latter one accesses the IMAP server over ssl.
+
+Both methods support the port number specification.
+
+Note, that special handling is needed for declaring a passphrase for
+encryption / decryption of the messages (@pxref{Using an
+authentication file}).
+
address@hidden ifset
 @end table
 
 
@@ -1050,7 +1075,9 @@
 @table @asis
 @item @option{dav}
 @cindex method dav
address@hidden method davs
 @cindex dav method
address@hidden davs method
 
 This method provides access to WebDAV files and directories.  There
 exists also the external method @option{davs}, which uses SSL
@@ -1058,6 +1085,7 @@
 
 Both methods support the port number specification as discussed above.
 
+
 @item @option{obex}
 @cindex method obex
 @cindex obex method
@@ -1065,6 +1093,7 @@
 OBEX is an FTP-like access protocol for simple devices, like cell
 phones.  Until now @value{tramp} supports only OBEX over Bluetooth.
 
+
 @item @option{synce}
 @cindex method synce
 @cindex synce method
@@ -1591,7 +1620,7 @@
 @value{tramp} offers altenatives.
 
 
address@hidden
address@hidden an authentication file}
 @subsection Using an authentication file
 
 @vindex auth-sources
@@ -1612,8 +1641,19 @@
 @pxref{External methods}), to match only this method.  When you omit
 the port, you match all @value{tramp} methods.
 
address@hidden emacsimap
+A special case are @option{imap}-like methods.  Authentication with
+the IMAP server is performed via @file{imap.el}, there is no special
+need from @value{tramp} point of view.  An additional passphrase, used
+for symmetric encryption and decryption of the stored messages, should
+be given with the special port indication @option{tramp-imap}:
+
address@hidden
+machine melancholia port tramp-imap login daniel password ultrageheim
address@hidden example
address@hidden ifset
 
address@hidden
address@hidden passwords}
 @subsection Caching passwords
 
 If there is no authentication file, @value{tramp} caches the passwords