X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=lib%2FOnis%2FPlugins%2FInterestingnumbers.pm;fp=lib%2FOnis%2FPlugins%2FInterestingnumbers.pm;h=b7e9b24b7200670fa52176d99a99674b10136f14;hb=bf61c85ba4eb614a955c607b39e310fde9463cc3;hp=4397db6a883481aa3385bb963046238306c80bb6;hpb=b35e3c4286bacccb72237b1550b6281418f772d8;p=onis.git

diff --git a/lib/Onis/Plugins/Interestingnumbers.pm b/lib/Onis/Plugins/Interestingnumbers.pm
index 4397db6..b7e9b24 100644
--- a/lib/Onis/Plugins/Interestingnumbers.pm
+++ b/lib/Onis/Plugins/Interestingnumbers.pm
@@ -11,6 +11,17 @@ use Onis::Language (qw(translate));
 use Onis::Data::Core (qw(register_plugin get_main_nick nick_to_name));
 use Onis::Data::Persistent;
 
+=head1 NAME
+
+Onis::Plugins::Interestingnumbers
+
+=head1 DESCRIPTION
+
+Counts actions, joins, given and received kicks and ops and soliloquies for
+each nick and prints the most significant nicks in a table.
+
+=cut
+
 @Onis::Plugins::Interestingnumbers::EXPORT_OK = (qw(get_interestingnumbers));
 @Onis::Plugins::Interestingnumbers::ISA = ('Exporter');
 
@@ -406,6 +417,25 @@ sub sort_by_field
 	return (@retval);
 }
 
+=head1 EXPORTED FUNCTIONS
+
+=over 4
+
+=item B<get_interestingnumbers> (I<$nick>)
+
+Returns a hash-ref with the interesting numbers (counters) for this nick. The
+hash-ref has the following fields:
+
+  actions
+  joins
+  kick_given
+  kick_received
+  op_given
+  op_taken
+  soliloquies
+
+=cut
+
 sub get_interestingnumbers
 {
 	my $nick = shift;
@@ -417,3 +447,11 @@ sub get_interestingnumbers
 
 	return ($InterestingNumbersData->{$nick});
 }
+
+=back
+
+=head1 AUTHOR
+
+Florian octo Forster, E<lt>octo at verplant.orgE<gt>
+
+=cut