Improve docs beyond a really terse synopsis

Also mention that using Sub::Util is encouraged instead.