As it is now, unqualified / relative class names in a DocBlock seem to be resolved relative to the namespace root:
PHPDoctor interprets this as \SomeClass. It would be more "intuitive" (and conforming to javadoc spec, IMHO) if it would be interpreted as \A\SomeClass. If the coder wanted to refer to \SomeClass, he could/should write so...
use some/namespace as b;
How should those be documented? I suppose, the full/absolute class name woud be best - but I'm not sure.
agree to that. but the second confuses me a bit