POE-Component-IRC-Plugin-Seen version 0.001001
==============================================
-POE::Component::IRC::Plugin::Seen is a PoCo-IRC plugin that remembers what each person around it did last.
+POE::Component::IRC::Plugin::Seen is a PoCo-IRC plugin that remembers
+what each person around it did last. It remembers public messages,
+joins and parts.
-When somebody sends him a private message of the form 'seen NICKNAME' or somebody says 'botnick: seen NICKNAME' in a channel with the bot, the plugin answers with the last action NICKNAME did.
+When somebody sends him a private message of the form 'seen NICKNAME'
+or somebody says 'seen NICKNAME' or 'botnick: seen NICKNAME' in a
+channel with the bot, the plugin answers with the last action NICKNAME
+did. There can be an exclamation mark before the word 'seen'.
INSTALLATION
COPYRIGHT AND LICENCE
-Copyright (C) 2013,2014 by Marius Gavrilescu
+Copyright (C) 2013-2015 by Marius Gavrilescu
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.14.2 or,
my $irc = POE::Component::IRC->spawn;
$irc->plugin_add(Seen => POE::Component::IRC::Plugin::Seen->new(filename => 'mycache.db'));
+ # In chat
+ # <mgv> Hi there!
+ # <foo> !seen mgv
+ # <bot> I last saw mgv [DATE] on channel #whatever saying Hi there!
+
=head1 DESCRIPTION
-POE::Component::IRC::Plugin::Seen is a PoCo-IRC plugin that remembers what each person around it did last.
+POE::Component::IRC::Plugin::Seen is a PoCo-IRC plugin that remembers
+what each person around it did last. It remembers public messages,
+joins and parts.
-When somebody sends him a private message of the form 'seen NICKNAME' or somebody says 'botnick: seen NICKNAME' in a channel with the bot, the plugin answers with the last action NICKNAME did.
+When somebody sends him a private message of the form 'seen NICKNAME'
+or somebody says 'seen NICKNAME' or 'botnick: seen NICKNAME' in a
+channel with the bot, the plugin answers with the last action NICKNAME
+did. There can be an exclamation mark before the word 'seen'.
=head1 METHODS
=item B<new>([I<filename> => value])
-Creates a new plugin object suitable for L<POE::Component::IRC>'s C<plugin_add> method.
+Creates a new plugin object suitable for L<POE::Component::IRC>'s
+C<plugin_add> method.
-Takes one optional argument, C<filename>, the name of the file to store the plugin's state in. If C<undef> or not given, it keeps the state in memory.
+Takes one optional argument, C<filename>, the name of the file to
+store the plugin's state in. If C<undef> or not given, it keeps the
+state in memory.
=back
=head1 COPYRIGHT AND LICENSE
-Copyright (C) 2013,2014 by Marius Gavrilescu
+Copyright (C) 2013-2015 by Marius Gavrilescu
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.14.2 or,