Supplemental documentation for the chomp method

[nheinric]

Just a trivial doco change, but please let me know if I should put this into a branch prior to submitting a pull request.

$ printf "hello\nthere\n\nreader" | perl -MIO::All -E'$io = io("-")->chomp; while ( $line = $io->getline ) { print $line; } say;'
hellothere
$

[ingydotnet]

Applied,released,thanks!

I reformatted the swim a bit, and also ran make doc to update the ReadMe.pod.