[wp-trac] [WordPress Trac] #49206: Update `wp_allow_comment()` and `pre_comment_approved` docs with possible `trash` return value

[WordPress Trac]

#49206: Update `wp_allow_comment()` and `pre_comment_approved` docs with possible
`trash` return value
--------------------------+----------------------------------------
 Reporter:  jeremyfelt    |      Owner:  (none)
     Type:  defect (bug)  |     Status:  new
 Priority:  normal        |  Milestone:  Awaiting Review
Component:  Comments      |    Version:
 Severity:  normal        |   Keywords:  needs-patch good-first-bug
  Focuses:  docs          |
--------------------------+----------------------------------------
 In `wp_allow_comment()`, if `wp_blacklist_check()` is `true` and
 `EMPTY_TRASH_DAYS` is defined and truthy, then `trash` is returned for the
 value of `$approved`.

 The docs for `wp_allow_comment()` and the `pre_comment_approved` filter
 should be updated to reflect this.

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