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

diff --git a/lib/Onis/Plugins/Bignumbers.pm b/lib/Onis/Plugins/Bignumbers.pm
index 0332ee4..ab862d1 100644
--- a/lib/Onis/Plugins/Bignumbers.pm
+++ b/lib/Onis/Plugins/Bignumbers.pm
@@ -11,6 +11,19 @@ use Onis::Data::Core (qw(get_main_nick register_plugin nick_to_name));
 use Onis::Data::Persistent ();
 use Onis::Plugins::Core (qw(get_core_nick_counters nick_is_in_main_table));
 
+=head1 NAME
+
+Onis::Plugins::Bignumbers - Information about nick specific channel
+characteristics
+
+=head1 DESCRIPTION
+
+This plugins detects questions, yelled text (all uppercase), (happy and sad)
+smileys, characters and words per line. It stores this information for each
+nick and prints a table containing the most significant nicks in each category.
+
+=cut
+
 @Onis::Plugins::Bignumbers::EXPORT_OK = (qw(get_bignumbers));
 @Onis::Plugins::Bignumbers::ISA = ('Exporter');
 
@@ -399,6 +412,26 @@ sub sort_by_field
 	return (@retval);
 }
 
+=head1 EXPORTED FUNCTIONS
+
+=over 4
+
+=item B<get_bignumbers> (I<$nick>)
+
+Returns all the data that was used to calculate the bignumbers-data for this
+nick. It's a hash-ref with the following fields. Each field holds a counter
+that counts the total occurences of that "event".
+
+  lines
+  words
+  chars
+  questions
+  uppercase
+  smiley_happy
+  smiley_sad
+
+=cut
+
 sub get_bignumbers
 {
 	my $nick = shift;
@@ -410,3 +443,11 @@ sub get_bignumbers
 
 	return ($CalcData->{$nick});
 }
+
+=back
+
+=head1 AUTHOR
+
+Florian Forster E<lt>octo at verplant.orgE<gt>
+
+=cut