DOC fix some confusing comments