added some phpdoc