added/updated some phpdoc blocks