lib/binary: document behavior when reading binary data with a pending error