update confusing comments

fix #16