[wp-trac] [WordPress Trac] #41121: Consistency of the _deprecated_function() calls and related documentation.

[WordPress Trac]

#41121: Consistency of the _deprecated_function() calls and related documentation.
----------------------------+---------------------------
 Reporter:  jrf             |       Owner:  DrewAPicture
     Type:  task (blessed)  |      Status:  reviewing
 Priority:  normal          |   Milestone:  4.9
Component:  General         |     Version:  trunk
 Severity:  normal          |  Resolution:
 Keywords:  has-patch       |     Focuses:  docs
----------------------------+---------------------------

Comment (by jrf):

 @DrewAPicture I changed it to explicitely mention the fact it is a filter
 to distinguish it from the expected/most common alternative being an
 alternative function.

 The `_deprecated_function()` documentation even explicitly mentions that a
 function is expected as the replacement:
 https://developer.wordpress.org/reference/functions/_deprecated_function/

 There are a few more exceptions where something else is used (not a
 function) and those are generally made more explicit as well.

 See:
 * https://core.trac.wordpress.org/browser/tags/4.8/src/wp-
 includes/deprecated.php#L2514
 * https://core.trac.wordpress.org/browser/tags/4.8/src/wp-
 admin/includes/deprecated.php#L804
 * https://core.trac.wordpress.org/browser/tags/4.8/src/wp-
 admin/includes/deprecated.php#L1141

--
Ticket URL: <https://core.trac.wordpress.org/ticket/41121#comment:12>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform