Joseph S. Myers wrote:
And in that case we did consider users: although the concatenation of __FUNCTION__ wasn't documented, it emitted a deprecation warning in the 3.0, 3.1/3.2 and 3.3 release series before being removed in 3.4.
Fair enough. I think it is useful to include documentation in a clear place when the incompatible change is finally made. Of course, not everyone will read it :-)