added doc files to some methods