updated interface and phpdoc comment.