Bug: __construct @return assumption of self

[alexrussell]

Going on the definitions in Appendix A, Subsection Keyword (bottom of document), shouldn't the assumed @return of a __construct method as mentioned in the exceptions to Section 8.15 be assumed @return static rather than the stated @return self?

[samdark]

Yes, it should be static, not self.

[lisachenko]

I think it will be better to use $this to reflect that returned object is an instance of that class. BTW, phpStorm supports this construction for phpDocs: @return $this

[samdark]

Yeah, even better.

[alexrussell]

Yeah that makes sense to me. I suppose by the time the constructor runs the instance exists (as the constructor can use $this, so the constructor is not a factory (@return static) but an initialiser, and so @return $this is a much better fit.