more explicit comment in phpdoc, code style