updating phpdoc for some methods