=======
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
or MSN 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 or MSN 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.se/ 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.

If you have your perl modules in an unusual place, you'll need to add
the line:

  use lib 'path/to/my/perl/modules';

to the gotmail script, somewhere near the top.

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. Work is being done on the problem.
* Mail in the Trash Can will not be downloaded. This is to avoid
  downloading two times any mail which is deleted by the script.
* 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 by e-mail:
==============================
* Include these things:
  - A brief description of your problem.
  - Run the script with --debug and send me the output ALONG WITH
    the "/tmp/gotmail_log" file generated by the script.
  - 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/)
* Don't call me "Peter". Peter isn't working on this anymore :).
* If you file a bug on Savannah, don't include all the log files and
  such; it's not as easy to read through them using a web browser :P

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
Hari Sundararaghavan
Silas S. Brown
Adrian Chung
Lalit Chhabra
Loic TREGOUET
Sean D. True
Timothy Lee
stripes
David Holland
Sergio Rua
Lee
William X. Walsh
Chris Ham
