=======
Gotmail
=======
Original by Peter Hawkins <peter@hawkins.emu.id.au>
Maintainer (0.6.6-2 to 0.7.10): paul cannon <pik@debian.org>
Current Maintainer: John Fruetel <jfruetel@hotmail.com>

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 7.9 or later (ssl is _required_ to use hotmail... )
         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.

Useful things to include in a bug report:
=========================================
* ALWAYS include at least:
  - A brief description of your problem.
  - Your ~/.gotmailrc file, if you use one.
* In most cases, this is also useful:
  - Run the script with --debug and send the output ALONG WITH
    the "/tmp/gotmail_log" file generated by the script. Attach
    those files to the email rather than just including the text.
    Especially don't include log text in a Savannah or SourceForge
    bug report! You can attach files there as well.

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 added 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
Angel Luis Jimenez Martinez
John Fruetel
