Can anyone tell me what the correct way to define php namespaces in phpDoc syntax is? Or, is @package deprecated in phpDoc, since namespaces more or less define a package?
If there is none, is there a common way to document the namespaces a document is in?
phpDoc doesn’t have a concept of namespaces but you can (and probably should) use @package for it.
You might take a look at the phplint documentation to see how they’re formatting namespaces.