[4.3] Deprecation reviews

[bembelimen]

The goal is to add a code example to each @deprecation in the Joomla core and also add clear versions when somehing was deprecated and the earliest version when it can be removed.

This PR is still a draft, as there is a lot of chaos and it takes some time to clean up (some versions will also change).

[wilsonge]

Is this hashtag deprecated format actually recognised by PHP Documentor? I'm only seeing this as a reference? https://docs.phpdoc.org/latest/guide/references/phpdoc/tags/deprecated.html

I mean I'm down for the concept. But I don't understand most the implementation

[bembelimen]

Is this hashtag deprecated format actually recognised by PHP Documentor?

No it isn't, that's my marker for the deprecations I already handled. Will then be converted at the end back to @

[brianteeman]

I wouldnt bother using the word "instead" its a superfluous word

Use \Joomla\Component\Finder\Administrator\Helper\LanguageHelper instead

==>

Use \Joomla\Component\Finder\Administrator\Helper\LanguageHelper

[brianteeman]

The last commits do not appear to belong here

[bembelimen]

The last commits do not appear to belong here

Indeed, thx.

[laoneo]

Why did you close?

[obuisard]

Thank you Benjamin @bembelimen for this thorough PR. It will be a great help.