Constructor tag

[varas]

It is needed some @constructor tag, becuase there could be static constructor methods in order to encapsulate different create intentions for the same class.

[boenrobot]

There's already talks about stuff like @signature tag, for the same purpose, except more generic, in that it would apply to any method, not just __construct()... But it's not as easy to define or implement, as it may seem.

An already possible (though half baked) workaround is to use the @method tag to define __construct() and other methods at the top of the class, but the downside is that this is decoupled from the original method (i.e. it's treated as a completely independent entity), rather than it serving as an "add-on" to it.

[felixfbecker]

I think phpdoc should simply recognise if a static class method has @return self