revise doc comments