phpdoc fixes
added a helper function fixed some phpdoc
small fixes + phpdoc updates