update docco comments