phpdoctor
phpdoctor copied to clipboard
missing namespace handling in DocBlock
As it is now, unqualified / relative class names in a DocBlock seem to be resolved relative to the namespace root:
namespace A; ...
- @return SomeClass
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...
Also: use some/namespace as b;
- @return b/SomeClass should be resolved.
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