update confusing comments