updated phpdoc and fixed generator read/write-only annotation