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