← Back to branch summary

~vm/vm/8.1.x

« back to all changes in this revision

Viewing changes to info/vm.texinfo

  • Committer: Uday S Reddy
  • Date: 2011-04-08 22:46:12 UTC
  • Revision ID: u.s.reddy@cs.bham.ac.uk-20110408224612-6kd3pecawdruub9n
https://launchpad.net/bugs/671940
Added vm-prune-imap-retrieved command.  (Backport of revision 1182 of trunk.)

Show diffs side-by-side

added added

removed removed

Lines of Context:
info/vm.texinfo
604
604
tells VM to retrieve all the messages in the IMAP mailbox regardless
605
605
of how many messages there are and how large the mailbox is.
606
606
 
 
607
@cindex expunging, IMAP messages
607
608
@findex vm-expunge-imap-messages
608
609
After VM retrieves messages from the mailbox, the default action is to
609
610
leave the original messages on the server unchanged.  They can be
652
653
)
653
654
@end example
654
655
 
 
656
@unnumberedsubsubsec Multiple access to IMAP spool files
 
657
 
 
658
A principal idea behind the IMAP protocol is that messages can be
 
659
retained on the server so that you can read them from multiple
 
660
locations, e.g., from office and home, or from other places on the
 
661
Internet while you travel.  If you access your IMAP mailbox from
 
662
multiple locations then you would need to plan your strategy for
 
663
expunging messages carefully.  For instance, if you access your work
 
664
mailbox from home, and both your office machine and home machine
 
665
expunge messages after retrieving them, then some of your mail will
 
666
end up on your office machine and some on your home machine.  That is
 
667
unlikely to be a successful strategy.
 
668
 
 
669
The best way to access IMAP mailboxes from multiple locations is to
 
670
use the facility of IMAP folders.  (@xref{POP and IMAP Folders}.)
 
671
However, if you prefer to download all mail to local folders, then
 
672
your best bet is to designate one of your machines as the principal
 
673
location for downloading mail and treat the other machines as
 
674
temporary mail reading sites.  In that case, you should set the
 
675
principal downloading location to expunge messages on the server and
 
676
set the other reading sites to leave the messages on the server
 
677
intact.  You can also manually run @code{vm-expunge-imap-messages} if
 
678
you are careful to remember which site should expunge messages and
 
679
which site should retain them.
 
680
 
 
681
@cindex X-VM-IMAP-Retrieved header
 
682
VM remembers the messages you have downloaded from an IMAP spool file
 
683
so that it can avoid downloading them again on your next visit.  The
 
684
list of these messages is written into a special mail header titled
 
685
@code{X-VM-IMAP-Retrieved} in your mail folder.  When you expunge IMAP
 
686
messages, their entries are deleted from the list.  However, when you
 
687
designate one of your machines as a reading site and never expunge
 
688
messages from there, then the @code{X-VM-IMAP-Retrieved} header on
 
689
that machine will only grow over time.  When the list gets excessively
 
690
long, it will slow down the saving of folders.
 
691
 
 
692
@findex vm-prune-imap-retrieved-list
 
693
To avoid the problem, you should prediodically run the command
 
694
@code{vm-prune-imap-retrieved-list}.  It will examine the IMAP server
 
695
to see which messages still exist and retain only their information in
 
696
the @code{X-VM-IMAP-Retrieved} header.
 
697
 
 
698
 
655
699
@node Index Files, Folder types,IMAP Spool Files, Local Folders
656
700
@unnumberedsubsec Index Files
657
701
@cindex index file