Fix for #3331

Fix for #3331
I think we all agree the phpdoc manual entry about that isn't very clear and rather confusing but I disagree with @dereuromark . It has meaning. Quite a clear one. 
This method class is deprecated BUT you MAY use it **until** the version mentioned at ``<version>``.

Like I said somewhere else, I would even add a second, also optional version number to indicate since when a certain method/class has been deprecated.