adds missing phpdoc comments 
fixes #272,fixes #273,fixes #274