doc some notes, and fix utf multi byte reads