added some PHPDOC