Mail::Webmail::Yahoo version 0.1
================================

******************************************************************************
*                                                                            *
*                       Mail Storage Quota Warning                           *
* Hello Yahoo Mail User!                                                     *
* You are approaching your quota of 6.0 Megabytes (MB) of storage. You are   *
* currently using 5.2 MB of storage.  (Details)                              *
*                                                                            *
*                         Expand your mailbox!                               *
*                                                                            *
* Get up to 100 MB of storage for your mailbox. Starting at just $9.99/year! *
* Please order more storage or delete older and/or larger messages so that   *
* you can be assured of sending and receiving mail.                          *
* We recommend that you keep at least 1 MB of space free for incoming mail.  *
* Please be sure to "empty" your trash after you have deleted your messages -*
* the space in your mailbox will not be freed until the trash folder is      *
* emptied.                                                                   *
*                                                                            *
******************************************************************************


If you've ever seen the above, this package might be for you. Frustrated by
the lack of bulk processing tools in Yahoo mail, I was prompted to write this
package. It allows you to download to your local machine all of the messages
in your Yahoo account, attachments included. Future versions will allow bulk
deletion, forwarding, and other useful mail functions.

This is version 0.1 of the Webmail::Yahoo package; it may therefore be
slightly brittle. While I have been testing it and using it on my own yahoo
accounts for several weeks, I would appreciate any feedback if, for example, 
it doesn't work under particular conditions.


Included in the distribution is a sample script, 'snagmail.pl', which should
be enough to get you started. It simply downloads the contents of your Yahoo
inbox and stores it to disk in mbox format. 

Call it with 

  snagmail.pl <yahoo username> <password> [<number of messages>]


INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

	LWP::UserAgent
	HTTP::Request
	HTTP::Headers
	HTTP::Cookies
	HTML::LinkExtor
	HTML::Entities
	Mail::Internet
	MIME::Base64
	HTML::FormParser
	HTML::TableExtractor
	HTML::TableContentParser
	CGI

COPYRIGHT AND LICENCE

Copyright (C) 2002  Simon Drabble  <sdrabble@cpan.org>