adds missing phpdoc comments 
fixes #197,fixes #198,fixes #199