DOC better deprecation warning messages.

The charset parameter has been replaced by encoding and the charset_error by
decode_error.