DOC: corrections in comments and displays