[wp-trac] [WordPress Trac] #36319: Post meta authorization filter docs are incorrect

[WordPress Trac]

#36319: Post meta authorization filter docs are incorrect
--------------------------------+-----------------------------
 Reporter:  ericlewis           |      Owner:
     Type:  defect (bug)        |     Status:  new
 Priority:  normal              |  Milestone:  Awaiting Review
Component:  Options, Meta APIs  |    Version:
 Severity:  normal              |   Keywords:
  Focuses:  docs                |
--------------------------------+-----------------------------
 The
 [https://github.com/WordPress/WordPress/blob/40455626f076dcc3d6e454f373da618bd261c898
 /wp-includes/capabilities.php#L252 doc] for the `auth_post_meta_*` filter
 says

 > Filter whether the user is allowed to add post meta to a post.

 This is not actually the case. If the filter returns false, the user will
 need to have the `edit_post_meta` cap. Otherwise, `edit_post` mapped meta
 caps apply.

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