updated PHPDoc for syntax suggestions