minor fixes to read message and docs