[wp-trac] [WordPress Trac] #48255: Consistent deprecation of action and filter hooks

[WordPress Trac]

#48255: Consistent deprecation of action and filter hooks
------------------------------------+-----------------------------
 Reporter:  jrf                     |      Owner:  (none)
     Type:  defect (bug)            |     Status:  new
 Priority:  normal                  |  Milestone:  Awaiting Review
Component:  General                 |    Version:  trunk
 Severity:  normal                  |   Keywords:  has-patch
  Focuses:  docs, coding-standards  |
------------------------------------+-----------------------------
 While testing a new sniff for WPCS, I ran into an number of
 inconsistencies regarding hook deprecation.

 In particular:
 * Over 30 deprecated hook call not using the
 `do_action_deprecated()`/`apply_filters_deprecated()` functions.
 * Not using `{@see ...}` for the replacement in the `@deprecated` tag,
 meaning the Dev handbook won't automatically link to the replacement.
 * Hook documentation not being in the most logical place for the hook.
 * `This filter is documented in ...` comments not using short docblock
 style.
 * A few deprecated hook calls in tests using version numbers which don't
 comply with the `x.x.x` version format.

 The attached patches would fix these inconsistencies.

 Related: #41121, #48252, #48254

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/48255>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform