fixed some typo, improved phpdoc