Add documentation

diff --git a/lib/Text/Homestuck.pm b/lib/Text/Homestuck.pm
index ff123cacfbed58a5023e7df00ac1d858383a1263..ef508f7e4a94a793233f2dc4c58cfe52a0d2105f 100644 (file)
--- a/lib/Text/Homestuck.pm
+++ b/lib/Text/Homestuck.pm
@@ -104,39 +104,34 @@ filter feferi => sub {
 
 1;
 __END__
-# Below is stub documentation for your module. You'd better edit it!
 
 =head1 NAME
 
-Text::Homestuck - Perl extension for blah blah blah
+Text::Homestuck - Emulate the typing quirks of Homestuck trolls
 
 =head1 SYNOPSIS
 
   use Text::Homestuck;
-  blah blah blah
+  say feferi 'HELLO WORLD!'; # )(-ELLO WORLD!
+  my @array = ('Move along.', 'Nothing to see here');
+  aradia for @array;
+  say "@array"; # m0ve al0ng n0thing t0 see here
 
 =head1 DESCRIPTION
 
-Stub documentation for Text::Homestuck, created by h2xs. It looks like the
-author of the extension was negligent enough to leave the stub
-unedited.
-
-Blah blah blah.
-
-=head2 EXPORT
-
-None by default.
-
+Text::Homestuck exports several subroutines, one for each typing quirk. There are 12 such functions right now, one for each pre-scratch troll: aradia, tavros, sollux, karkat, nepeta, kanaya, terezi, vriska, equius, gamzee, eridan, feferi.
 
+Each subroutine takes one or no arguments. If called with an argument, they apply the quirk to the argument and return the result. If called with no arguments, they apply the quirk to C<$_>, modifiying it in-place, and returning C<$_>.
 
 =head1 SEE ALSO
 
 Homestuck: L<http://mspaintadventures.com/?s=6&p=001901>
-The mspa wiki page listing the quirks: http://mspaintadventures.wikia.com/wiki/Typing_Quirk
+
+A table of typing quirks: L<http://mspaintadventures.wikia.com/wiki/Typing_Quirk>
 
 =head1 AUTHOR
 
-Marius Gavrilescu, E<lt>marius@E<gt>
+Marius Gavrilescu C<< <marius@ieval.ro> >>
 
 =head1 COPYRIGHT AND LICENSE