added phpdoc blocks