[wp-trac] [WordPress Trac] #51378: Taxonomy is missing from wp_list_categories inline documentation

[WordPress Trac]

#51378: Taxonomy is missing from wp_list_categories inline documentation
------------------------------+-----------------------------
 Reporter:  grapplerulrich    |       Owner:  SergeyBiryukov
     Type:  defect (bug)      |      Status:  reviewing
 Priority:  normal            |   Milestone:  5.6
Component:  Taxonomy          |     Version:
 Severity:  normal            |  Resolution:
 Keywords:  has-patch commit  |     Focuses:  docs
------------------------------+-----------------------------

Comment (by SergeyBiryukov):

 Thanks for the PR! The first part of it is now committed.

 Some history on the second part:
 * The description of the `taxonomy` argument in `wp_list_categories()` was
 intentionally removed in [45894], see comment:12:ticket:47896 and
 comment:8:ticket:41058 for the reasoning. The DocBlock includes a
 reference to `get_categories()`, `get_terms()`, and
 `WP_Term_Query::__construct()` for information on additional accepted
 arguments.
 * That said, the same was done for `wp_dropdown_categories()`. The
 `taxonomy` parameter was removed in [40903] and then reinstated in
 [41767], since it's different from the default in
 `WP_Term_Query::__construct()`.
 * With the above in mind, it should probably be reinstated for
 `wp_list_categories()` too.

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