missing namespace handling in DocBlock #13

Open
KampfCaspar opened this Issue Jun 28, 2010 · 1 comment

Projects

None yet

2 participants

@KampfCaspar

As it is now, unqualified / relative class names in a DocBlock seem to be resolved relative to the namespace root:

namespace A;
...

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.

@beikov
beikov commented Aug 16, 2010

agree to that. but the second confuses me a bit

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment