mirror of
https://github.com/pragma-/pbot.git
synced 2024-12-25 12:12:34 +01:00
150 lines
4.9 KiB
Plaintext
150 lines
4.9 KiB
Plaintext
Net::IRC 0.72 README T.J. Eckman Mon Jul 02 00:00:00 GMT 2000
|
|
==============================================================================
|
|
|
|
Table of Contents
|
|
------------------------
|
|
|
|
0. Deprecation notice
|
|
0.1. Forked by pragma- for PBot
|
|
1. Introduction
|
|
2. Availability
|
|
3. Prerequisites
|
|
4. Installation
|
|
+- 4.1 Windows Installation
|
|
5. Demonstration Script
|
|
6. Bugs
|
|
7. Disclaimer
|
|
8. Copyright
|
|
9. Developer Information
|
|
|
|
|
|
|
|
0. Deprecation notice
|
|
------------------------
|
|
|
|
This module is officially DEPRECATED. It has been abandoned in favor of more
|
|
modern approaches, including Bot::BasicBot and POE::Component::IRC. This release
|
|
only serves to warn current and new users about the status of this distribution.
|
|
|
|
0.1. Forked by pragma- for PBot
|
|
------------------------
|
|
This module has been forked as part of PBot. It has been added privately to
|
|
PBot's repository because I do not have CPAN access, nor am I sure if CPAN would
|
|
appreciate my contributions. As such, this version of Net::IRC is now PBot::IRC
|
|
and it has been continually updated and improved with bugfixes and improvements,
|
|
including support for the IRCv3 specification.
|
|
|
|
1. Introduction
|
|
------------------------
|
|
|
|
Welcome to Net::IRC, a work in progress. First intended to be a quick tool
|
|
for writing an IRC script in Perl, Net::IRC has grown into a comprehensive
|
|
Perl implementation of the IRC protocol (RFC 1459).
|
|
|
|
|
|
2. Availability
|
|
------------------------
|
|
|
|
CPAN, of course. http://www.perl.com/CPAN/modules/by-module/Net/
|
|
Also, Sourceforge: http://sourceforge.net/project/net-irc
|
|
|
|
|
|
3. Prerequisites
|
|
------------------------
|
|
|
|
Net::IRC requires Perl version 5.004 or higher to install and run.
|
|
Hypothetically, it could run on 5.003_9something with IO::* installed, but
|
|
you may as well upgrade anyhow. The latest version of Perl can be found at
|
|
http://www.perl.com/CPAN/src/latest.tar.gz (for UNIX), or at
|
|
http://www.perl.com/CPAN/ports/ for various non-Unix machines.
|
|
|
|
Net::IRC tries to use the Time::HiRes module by default, but will fail
|
|
silently if you do not have it. If you have Time::HiRes pacing settings
|
|
and calls to schedule() can be fractional.
|
|
|
|
|
|
4. Installation
|
|
------------------------
|
|
|
|
Same old, same old. If you get through all these steps without anything
|
|
emitting horrible dire warning messages, you're all set. In particular, the
|
|
"perl Makefile.PL" will barf if run with older versions of Perl, but if you
|
|
read the Prerequisites section of this README, you already know that, right?
|
|
|
|
Do this, in the following order:
|
|
|
|
perl Makefile.PL
|
|
make
|
|
make install
|
|
|
|
We don't have any automated tests yet, but they might be in the not-too-
|
|
distant future. You may instead wish to play around with the...
|
|
|
|
=> 4.1 Windows Installation
|
|
|
|
If you don't have a copy of 'make' on your machine, the easiest way to
|
|
install this module is to unzip the file into a local directory, and
|
|
copy the component files like this:
|
|
IRC.pm => path.to.perl/site/lib/Net/IRC.pm
|
|
Connection.pm => path.to.perl/site/lib/Net/IRC/Connection.pm
|
|
Event.pm => path.to.perl/site/lib/Net/IRC/Event.pm
|
|
DCC.pm => path.to.perl/site/lib/Net/IRC/DCC.pm
|
|
|
|
5. Demonstration Script
|
|
------------------------
|
|
|
|
A sample Net::IRC script is included with the distribution, under the
|
|
creative name "irctest". It doesn't do much more than connect to a server and
|
|
print annoying messages to anyone who talks to it, but that should be enough
|
|
to give you an idea of how the whole enchilada fits together until we actually
|
|
get some real documentation written. Just don't be surprised if IRC admins get
|
|
a clue about it and start killing it as soon as they see one log on...
|
|
|
|
Oh, and by the way... if you say "Send me <filename>" to an irctest
|
|
bot, it will send the specified file (if it can) as a demonstration of
|
|
Net::IRC's DCC and scheduler interface. This is a potential security hole, so
|
|
be careful.
|
|
|
|
|
|
|
|
6. Bugs
|
|
------------------------
|
|
|
|
Please submit bugs at the sourceforge project page for Net::IRC.
|
|
See section 9 for the address.
|
|
|
|
|
|
7. Disclaimer
|
|
------------------------
|
|
|
|
This software is under no warranty, explicit or implied. Use at
|
|
your own risk.
|
|
|
|
|
|
8. Copyright
|
|
------------------------
|
|
|
|
This module copyright (c) 1997 Greg Bacon & Dennis Taylor. All rights
|
|
reserved. This module is free software; you can redistribute it and/or
|
|
modify it under the terms of the Perl Artistic License, distributed with
|
|
this module.
|
|
|
|
Any changes after 0.70, but before 0.72, are copyright Peter Sergeant,
|
|
and/or the people who submitted them.
|
|
|
|
Any changes after 0.71 are copyright T.J. Eckman, and/or the people
|
|
who submitted them.
|
|
|
|
Any changes after 0.73 are under the ownership of their respective
|
|
submitters.
|
|
|
|
9. Developer Information
|
|
------------------------
|
|
|
|
Maintenance is now handled via sourceforge:
|
|
|
|
http://sourceforge.net/projects/net-irc/
|
|
|
|
Bug reports, feature requests and patches should be submitted at the
|
|
above address.
|