Net-YIM version 0.01
====================

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

TEST SCRIPT

This distribution includes a test script, "test.pl" - running this
script allows you to easily test the module. It will ask for three
fields upon startup:

  YahooID>  A Yahoo! username for the "bot" to sign on with.
  Password> The password to the above mentioned YahooID.
  Contact>  A username for the "bot" to say hello to right when it
            signs on (optional).

The test also displays two ways in which you can send a message with
fonts/colors: doing it the hard way (as in on_connect) or the easy way
(on_im).

DEPENDENCIES

This module requires these other modules and libraries:

  strict
  warnings
  IO::Socket
  IO::Select
  LWP::UserAgent
  HTTP::Request
  Data::Dumper

COPYRIGHT AND LICENCE

  Net::YIM - Perl interface to Yahoo Messenger
  Copyright (C) 2005  Cerone Kirsle

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  - Used protocol docs from http://www.venkydude.com/articles/yahoo.htm
  - Some code referenced from Matt Austin's YahooSimple.pm (www.bot-depot.com)