=======
Gotmail
=======
Original by Peter Hawkins <peter@hawkins.emu.id.au>
Current Maintainer: paul cannon <pik@debian.org>

Description:
============
This is Gotmail, a perl script to fetch mail out of your Hotmail
account. This is especially useful if you want to move from Hotmail
into one of the other free mail services - one command can do it
all. Gotmail also supports getting any new mail only from your Hotmail
account - perfect for using a Hotmail account as a redirect address
into another account.

Requirements:
=============
* Perl 5
* curl-ssl 6.5.2 or later (ssl is _required_ to use hotmail... )
   NOTE: VERSION 6.5.2 IS **REQUIRED**! YES REALLY! 6.0, at least, WILL
         NOT WORK (it will segfault). It's debian package "curl-ssl" for
         those who are running debian. You can get it from
         http://curl.haxx.nu/ if you aren't. 
* The URI cpan module (liburi-perl debian package, or
                       http://search.cpan.org/search?dist=URI)
* The libnet cpan module (libnet-perl debian package, or
                          http://search.cpan.org/search?dist=libnet)

Usage:
======
If your perl interpreter is not in /usr/bin, you will need to edit the
first line of the script to make it point to the correct place, or
start the script using /path/to/perl gotmail.

Read the included manpage (gotmail(1)) or try "gotmail --help" for
usage instructions.

A sample rc file is included called "sample.gotmailrc". Options from
the command line will override those from the rc file.

Notes:
======
* Mail in the Sent Messages or Drafts folders cannot be saved at the
  moment. Please tell me if this is a huge problem. It's a little harder
  to get email messages from these two folders.
* Mail in the Trash Can will not be downloaded. This is to avoid
  downloading two times any mail which is deleted by the script. Again,
  does this trouble you?
* If the page structure of HotMail is changed, this script may stop
  working. If that happens, file a bug so that I'm sure to know about it.

How to report a bug:
====================
* Include these things:
  - A brief description of your problem.
  - Run the script with --debug and send me the "/tmp/gotmail_log"
    file generated by the script. (This will reveal your password to
    me, so you may wish to change your password to something different
    temporarily, and change it back after you have done this step.
  - Your ~/.gotmailrc file, if you use one.
* Send a message containing these things to me at pik@debian.org or
  include them in a Debian bug (see http://www.debian.org/Bugs/)

Thanks:
=======
To all who contributed by sending patches, feedback, comments, etc.

Peter Hawkins thanked these people in his README:

Leigh Purdie
"Sh" (whatever your name is =)
Patrick Froede
Herman Mereles
Kamal Kantawala
Andrei Popov
Kamal Mahyuddin
Hindu
Joel Mejeur
Wesley Hosking
Max Hales
Brian Almeida

paul cannon would like to add thanks to:

Peter Hawkins himself
Jens Preikschat
Jonas Smedegaard
Robert Lazzurs
Tim Dijkstra
Silas S. Brown
Adrian Chung
