document decode_utf8 behaviour more precise

proposed improvement for documentation, for RT#87267