[wp-trac] [WordPress Trac] #48053: incomplete DocBlock for get_bookmarks()

[WordPress Trac]

#48053: incomplete DocBlock for get_bookmarks()
-------------------------+-----------------------------
 Reporter:  pbiron       |      Owner:  (none)
     Type:  enhancement  |     Status:  new
 Priority:  normal       |  Milestone:  Awaiting Review
Component:  General      |    Version:
 Severity:  normal       |   Keywords:  has-patch
  Focuses:  docs         |
-------------------------+-----------------------------
 The DocBlock (and hence, the code reference) for
 [https://developer.wordpress.org/reference/functions/get_bookmarks/
 get_bookmarks()] is incomplete.

 In particular,

 1. the `$search` param is not mentioned at all
 2. the description of the `$orderby` param leaves out `rand` and `length`
 as possible values,  as well as the "shorthands" for the various fields in
 the `wp_links` table
 3. the description of the `$limit` param may be misleading, implying that
 '1+' is a legal value

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