some typos and phpdoc