Introduce a function for deprecated options

[desrosj]

While tackling #50413, two option keys were renamed. In the absence of a _deprecated_function() equivalent for options, a temporary backwards compatibility fix was added in [48575] with the goal of exploring a _deprecate_option() function in 5.6.

[desrosj]

approach-2.diff​ was an initial first pass at what this may look like originally uploaded to ticket:50413#comment:38.

It needs a refresh, and still needs additional considerations. From the previous comment:

It is not yet handling database queries (which key should be checked retrieved/updated/deleted when calling a deprecated option? The new one? The old one?), but it does ensure that both the new and old actions and filters run.

[TobiasBg]

The call _deprecated_option( $option, '5.5.0', $deprecated_options[ $option ] ); won't work for deprecated options in future versions. The version information probably has to go to get_deprecated_options().

[desrosj]

Ah yes. That will need an adjustment. The context of approach-2.diff​ was limited to 5.5.

I think I like the suggestion of using get_deprecated_options() to provide the version details.

[hellofromTonya]

During today's core scrub, agreed this ticket needs more work and to punt it to Future Release.

If any maintainer or committer feels this can be resolved in time, or wishes to assume ownership during a specific cycle, feel free to update the milestone accordingly.