Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

missing namespace handling in DocBlock #13

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

missing namespace handling in DocBlock #13

KampfCaspar opened this issue Jun 28, 2010 · 1 comment

Comments

@KampfCaspar
Copy link
Contributor

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
Copy link

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
Projects
None yet
Development

No branches or pull requests

2 participants