revise comments a little