[wp-trac] [WordPress Trac] #37402: Standardise documentation for variadic functions

[WordPress Trac]

#37402: Standardise documentation for variadic functions
------------------------------------------------+--------------------------
 Reporter:  johnbillion                         |       Owner:
     Type:  task (blessed)                      |      Status:  new
 Priority:  normal                              |   Milestone:  Future
Component:  General                             |  Release
 Severity:  minor                               |     Version:
 Keywords:  needs-patch needs-docs 2nd-opinion  |  Resolution:
                                                |     Focuses:  docs
------------------------------------------------+--------------------------

Comment (by mariovalney):

 So. For examaple, to `do_action` we should do this?

 {{{
  * @param string $tag     The name of the action to be executed.
  * @param mixed  ...$arg  Optional. Additional arguments which are passed
 on to the
  *                        functions hooked to the action. Default empty.
 }}}


 Mixing the defined parameters and adding a variadic definition to others?

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