Docs: Switch to the more common syntax for variadic function documentation.

See #37402

Built from https://develop.svn.wordpress.org/trunk@45418


git-svn-id: http://core.svn.wordpress.org/trunk@45229 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-includes/class-wp-user.php

@@ -722,7 +722,7 @@ class WP_User {
 	 * @see map_meta_cap()
 	 *
 	 * @param string $cap          Capability name.
-	 * @param int    $object_id,... Optional. ID of a specific object to check against if `$cap` is a "meta" capability.
+	 * @param int    ...$object_id Optional. ID of a specific object to check against if `$cap` is a "meta" capability.
 	 *                             Meta capabilities such as `edit_post` and `edit_user` are capabilities used by
 	 *                             by the `map_meta_cap()` function to map to primitive capabilities that a user or
 	 *                             role has, such as `edit_posts` and `edit_others_posts`.

wp-includes/deprecated.php

@@ -2109,7 +2109,7 @@ function attribute_escape( $text ) {
  * @param string|int $name            Widget ID.
  * @param callable   $output_callback Run when widget is called.
  * @param string     $classname       Optional. Classname widget option. Default empty.
- * @param mixed      $params ,...     Widget parameters.
+ * @param mixed      ...$params       Widget parameters.
  */
 function register_sidebar_widget($name, $output_callback, $classname = '') {
 	_deprecated_function( __FUNCTION__, '2.8.0', 'wp_register_sidebar_widget()' );

wp-includes/formatting.php

@@ -4812,7 +4812,7 @@ function wp_pre_kses_less_than_callback( $matches ) {
  * @link https://secure.php.net/sprintf
  *
  * @param string $pattern The string which formatted args are inserted.
- * @param mixed  $args ,... Arguments to be formatted into the $pattern string.
+ * @param mixed  ...$args Arguments to be formatted into the $pattern string.
  * @return string The formatted string.
  */
 function wp_sprintf( $pattern ) {

wp-includes/plugin.php

@@ -172,7 +172,7 @@ function has_filter( $tag, $function_to_check = false ) {
  *
  * @param string $tag    The name of the filter hook.
  * @param mixed  $value  The value on which the filters hooked to `$tag` are applied on.
- * @param mixed  $var,... Additional variables passed to the functions hooked to `$tag`.
+ * @param mixed  ...$var Additional variables passed to the functions hooked to `$tag`.
  * @return mixed The filtered value after all hooked functions are applied to it.
  */
 function apply_filters( $tag, $value ) {
@@ -422,7 +422,7 @@ function add_action( $tag, $function_to_add, $priority = 10, $accepted_args = 1
  * @global array $wp_current_filter Stores the list of current filters with the current one last
  *
  * @param string $tag    The name of the action to be executed.
- * @param mixed  $arg,... Optional. Additional arguments which are passed on to the
+ * @param mixed  ...$arg Optional. Additional arguments which are passed on to the
  *                       functions hooked to the action. Default empty.
  */
 function do_action( $tag, $arg = '' ) {

wp-includes/theme.php

@@ -2334,7 +2334,7 @@ function get_theme_starter_content() {
  *                        'post-thumbnails', 'html5', 'custom-logo', 'custom-header-uploads',
  *                        'custom-header', 'custom-background', 'title-tag', 'starter-content',
  *                        'responsive-embeds', etc.
- * @param mixed  $args,... Optional extra arguments to pass along with certain features.
+ * @param mixed  ...$args Optional extra arguments to pass along with certain features.
  * @return void|bool False on failure, void otherwise.
  */
 function add_theme_support( $feature ) {

wp-includes/version.php

@@ -13,7 +13,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '5.3-alpha-45417';
+$wp_version = '5.3-alpha-45418';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.

wp-includes/wp-db.php

@@ -1289,7 +1289,7 @@ class wpdb {
 	 * @param string      $query   Query statement with sprintf()-like placeholders
 	 * @param array|mixed $args    The array of variables to substitute into the query's placeholders if being called with an array of arguments,
 	 *                             or the first variable to substitute into the query's placeholders if being called with individual arguments.
-	 * @param mixed       $args,... further variables to substitute into the query's placeholders if being called wih individual arguments.
+	 * @param mixed       ...$args further variables to substitute into the query's placeholders if being called wih individual arguments.
 	 * @return string|void Sanitized query string, if there is a query to prepare.
 	 */
 	public function prepare( $query, $args ) {