[wp-trac] [WordPress Trac] #63900: Improve PHPDoc for wp_parse_id_list() in functions.php

[WordPress Trac]

#63900: Improve PHPDoc for wp_parse_id_list() in functions.php
-------------------------------------------------+-------------------------
 Reporter:  prab18hat                            |       Owner:  (none)
     Type:  defect (bug)                         |      Status:  new
 Priority:  normal                               |   Milestone:  Awaiting
                                                 |  Review
Component:  General                              |     Version:
 Severity:  normal                               |  Resolution:
 Keywords:  needs-docs has-patch has-unit-tests  |     Focuses:
-------------------------------------------------+-------------------------

Comment (by SergeyBiryukov):

 Hi there, welcome back to WordPress Trac! Thanks for the PR.

 > Expanded the PHPDoc to specify accepted parameter types
 (int|string|array)

 The purpose of this change is not quite clear to me, as
 `wp_parse_id_list()` is not supposed to accept an `int` value. It accepts
 an array, comma- or space-separated list of IDs:
 * `array( 1, 2, 3 )`
 * `'1, 2, 3'`
 * `'1 2 3'`
 so the existing `@param` tag of `array|string` looks correct to me.

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