[wp-trac] [WordPress Trac] #32694: current_user_can function is able to take post_id as argument, but it is not documented in WordPress documentation.

[WordPress Trac]

#32694: current_user_can function is able to take post_id as argument, but it is
not documented in WordPress documentation.
--------------------------+------------------------------
 Reporter:  jliman        |       Owner:
     Type:  defect (bug)  |      Status:  new
 Priority:  normal        |   Milestone:  Awaiting Review
Component:  General       |     Version:
 Severity:  normal        |  Resolution:
 Keywords:  needs-patch   |     Focuses:  docs
--------------------------+------------------------------
Changes (by DrewAPicture):

 * keywords:   => needs-patch
 * focuses:   => docs
 * version:  4.2.1 =>


Comment:

 Yeah, we're pretty bad about documenting functions that leverage
 `func_get_args()` for variable numbers of arguments.

 I distinctly remember being frustrated by the lack of documentation on
 `add_query_arg()`, for instance, so I added some parameter docs there. We
 should probably do an audit and actually try to document any of these
 "variable-argument" functions in core.

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