[Q21.5] Handle UTF-8 more robustly; pass through information about incorrect sequences

[Stephen J. Turnbull]

QUERY 21.5

Aidan Kehoe writes:

 > I’m running with this code,

Please document the in-buffer and on-disk formats properly,
specifically describing how to invert, or if they're not invertible,
explain under what conditions.