added new methods and phpdocs