some phpdoc annotations were added