Document that warnings::warn uses carp/croak

This has been confusing people since at least 2002, see here: http://www.perlmonks.org/?node_id=188508
Merge pull request #1 from jberger/patch-1

Document that warnings::warn uses carp/croak