getmail4 for Debian
-------------------

getmail4 package includes a Debian specific convenience wrapper script
getmails to ease maintenance of multiple mail accounts.  Instead of using
single ~/.getmailrc, getmails uses files matching ~/.getmail/config/* .

See getmails(1) manpage for its command syntax.

Tutorial for getmails
~~~~~~~~~~~~~~~~~~~~~

For example,  you can create ~/.getmail/config/foo.bar@gmail.com as follows:

=== start of ISP1 ===
[retriever]
type = SimplePOP3SSLRetriever
server = pop.gmail.com
username =  foo.bar@gmail.com
password = secretbaz

[destination]
type = MDA_external
path = /usr/bin/maildrop
unixfrom = True

[options]
verbose = 0
delete = True
delivered_to = False
message_log = ~/.getmail/log/foo.bar@gmail.com.log
=== end of ISP1 ===

(Here, maildrop package is used to filter incoming mail instead of more
 conventional procmail.)

This configuration enables retrieval of mails from foo.bar@gmail.com .

When you have 3 accounts at different ISPs, you can create configuration files
for these 3 ISPs as:
 *  ~/.getmail/config/ISP1
 *  ~/.getmail/config/ISP2
 *  ~/.getmail/config/.ISP3

getmails only uses ISP1 and ISP2 only and skips .ISP3.  I.e., you can turn 
on and off mail accounts by renaming their configuration files.

This made more intuitive to maintain multiple accounts, at least, for this
maintainer.

 -- Osamu Aoki <osamu@debian.org>, Sat, 12 Nov 2011 14:06:15 +0000

