added some phpdoc/fixed