use proper phpdoc blocks

converted from current notation
i kept changes to the bare minimum but at least it's now looking good in vscode ;-)