sync some comments with documentation