Add context to "%1$s is deprecated" strings

[SergeyBiryukov]

In the _deprecated_*() functions family, there are some commonly used strings:

• %1$s is <strong>deprecated</strong> since version %2$s! Use %3$s instead.
• %1$s is <strong>deprecated</strong> since version %2$s with no alternative available.

The problem is that these strings are used for several completely different entities: PHP functions, PHP file names, and WordPress hooks.

While the strings do have translator comments, it would also be helpful for translators to be able to differentiate these strings and say what exactly is deprecated: a function, a file name, or a hook.

Another option would be to make the original strings more explicit instead:

• Function %1$s is <strong>deprecated</strong> since version %2$s! Use %3$s instead.
• Function %1$s is <strong>deprecated</strong> since version %2$s with no alternative available.
• File %1$s is <strong>deprecated</strong> since version %2$s! Use %3$s instead.
• File %1$s is <strong>deprecated</strong> since version %2$s with no alternative available.
• Hook %1$s is <strong>deprecated</strong> since version %2$s! Use %3$s instead.
• Hook %1$s is <strong>deprecated</strong> since version %2$s with no alternative available.

[mukesh27]

@SergeyBiryukov Looks good. It helps the translator a lot to understand what has deprecated a function, a file name, or a hook.

Patch looks good to me.

[SergeyBiryukov]

Thanks for reviewing!

Replying to SergeyBiryukov:

Another option would be to make the original strings more explicit instead

The more I think about it, the more I like this latter option, as it makes the original strings clearer, so here's a patch in that direction as well.

[audrasjb]

54658.2.diff really looks better to me. A more detailed information about what is the item is useful for everyone and not only polyglots :)

[SergeyBiryukov]

Thanks for the feedback! :)

[SergeyBiryukov]

In 52609:

General: Clarify the deprecation messages in the _deprecated_*() functions family.

This makes the strings easier to translate and provides more details about what exactly is deprecated: a PHP function, a file name, or a WordPress hook.

The changes apply to:

• _deprecated_function()
• _deprecated_constructor()
• _deprecated_file()
• _deprecated_argument()
• _deprecated_hook()
• _doing_it_wrong()

Follow-up to [6514], [7884], [12536], [12584], [16939], [16942], [16945], [24439], [24723], [32989], [37861], [39315].

Props mukesh27, audrasjb, SergeyBiryukov.
Fixes #54658.