improved some PHPDoc comments