improve unpackstring() API docs

See ticket RT #116366 for the full discussion