DCOM-36: Declare annotation namespaces in the class' doc comment

[doctrinebot]

Jira issue originally created by user kriswallsmith:

I would like to declare my default annotation namespace and namespace aliases in my class' doc comment. This will ensure my class can be understood by the annotation reader regardless of its configuration.

An example of how I would use this:
https://gist.github.com/821412

[doctrinebot]

Comment created by @jwage:

I don't think implementing this is possible in any easy way.

[doctrinebot]

Comment created by @guilhermeblanco:

This cannot be done without adding a lot of WTF factor to Doctrine codebase.

For individual docblocks there's a simple way, but it is impossible to make they interchange definitions (like declare namespace on class docblock and take advantage of it on method docblock).

Marking it as can't fix, since our structure cannot support it without a complete rewrite (which would collide with our current interests).

[doctrinebot]

Issue was closed with resolution "Can't Fix"