doc update + source code's correction