* 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.

diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index b75d1d27c6f479941e3140120e1e975614afb840..2a8eb8be8f4250604ca05b704d44ecd4aee050a7 100644 (file)
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,13 @@
+2009-09-28  Michael Albinus  <michael.albinus@gmx.de>
+
+       * 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.
+
+       * trampver.texi: Set default value of `emacsimap'.
+
 2009-09-22  Daiki Ueno  <ueno@unixuser.org>
 
        * gnus.texi (Security): Document mm-sign-option and mm-encrypt-option.

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 2021a6ecd0dfe01a2c8e4a0f2f4a813bcf64ea88..91eaab1b201eea1a52fee67a928ea8572f2ef588 100644 (file)
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -440,17 +440,19 @@ was changed to @file{rcp.el}, and now it's @value{tramp}.  Along the way,
 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
+@ifset emacsimap
+Storing files into IMAP mailboxes has been added in September 2009.
+@end 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 @@ Windows, this method isn't available.  Instead of, you can use UNC
 file names like @file{//melancholia/daniel$$/.emacs}.  The only
 disadvantage is that there's no possibility to specify another user
 name.
+
+
+@ifset emacsimap
+@item @option{imap}
+@cindex method imap
+@cindex method imaps
+@cindex imap method
+@cindex 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.
+
+@value{tramp} 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}).
+
+@end ifset
 @end table
 
 
@@ -1050,7 +1075,9 @@ Therefore, your @value{emacsname} must have D-Bus integration,
 @table @asis
 @item @option{dav}
 @cindex method dav
+@cindex method davs
 @cindex dav method
+@cindex 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 @@ encryption for the access.
 
 Both methods support the port number specification as discussed above.
 
+
 @item @option{obex}
 @cindex method obex
 @cindex obex method
@@ -1065,6 +1093,7 @@ Both methods support the port number specification as discussed above.
 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 @@ However, if you cannot apply such native password handling,
 @value{tramp} offers altenatives.
 
 
-@anchor{auth-sources}
+@anchor{Using an authentication file}
 @subsection Using an authentication file
 
 @vindex auth-sources
@@ -1612,8 +1641,19 @@ The port can be any @value{tramp} method (@pxref{Inline methods},
 @pxref{External methods}), to match only this method.  When you omit
 the port, you match all @value{tramp} methods.
 
+@ifset 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}:
+
+@example
+machine melancholia port tramp-imap login daniel password ultrageheim
+@end example
+@end ifset
 
-@anchor{password-cache}
+@anchor{Caching passwords}
 @subsection Caching passwords
 
 If there is no authentication file, @value{tramp} caches the passwords