diff --git a/wp-admin/includes/class-wp-list-table.php b/wp-admin/includes/class-wp-list-table.php index 04028c501..814208bdb 100644 --- a/wp-admin/includes/class-wp-list-table.php +++ b/wp-admin/includes/class-wp-list-table.php @@ -737,7 +737,7 @@ class WP_List_Table { * @since 3.1.0 * @access protected * - * @param $object $item The current item + * @param object $item The current item */ function single_row( $item ) { static $row_class = ''; @@ -754,7 +754,7 @@ class WP_List_Table { * @since 3.1.0 * @access protected * - * @param $object $item The current item + * @param object $item The current item */ function single_row_columns( $item ) { list( $columns, $hidden ) = $this->get_column_info(); diff --git a/wp-admin/includes/plugin-install.php b/wp-admin/includes/plugin-install.php index 33d7f07e8..beb54676f 100644 --- a/wp-admin/includes/plugin-install.php +++ b/wp-admin/includes/plugin-install.php @@ -157,9 +157,6 @@ add_action('install_plugins_upload', 'install_plugins_upload', 10, 1); * Display plugin content based on plugin list. * * @since 2.7.0 - * - * @param array $plugins List of plugins. - * @param int $total_plugins Number of plugins. */ function display_plugins_table() { global $wp_list_table; diff --git a/wp-includes/cache.php b/wp-includes/cache.php index dbefabf25..895c43161 100644 --- a/wp-includes/cache.php +++ b/wp-includes/cache.php @@ -171,8 +171,6 @@ function wp_cache_add_non_persistent_groups( $groups ) { * this function instructs the backend to reset those keys and perform any cleanup since blog or site IDs have changed since cache init. * * @since 2.6.0 - * - * @param string|array $groups A group or an array of groups to add */ function wp_cache_reset() { global $wp_object_cache; diff --git a/wp-includes/category-template.php b/wp-includes/category-template.php index 37fd19409..3a7d9ae72 100644 --- a/wp-includes/category-template.php +++ b/wp-includes/category-template.php @@ -1174,7 +1174,7 @@ function has_tag( $tag = '', $post = null ) { * * @param string|int|array $term Optional. The term name/term_id/slug or array of them to check for. * @param string $taxonomy Taxonomy name - * @param int|post object Optional. Post to check instead of the current post. + * @param int|object $post Optional. Post to check instead of the current post. * @return bool True if the current post has any of the given tags (or any tag, if no tag specified). */ function has_term( $term = '', $taxonomy = '', $post = null ) { diff --git a/wp-includes/class.wp-dependencies.php b/wp-includes/class.wp-dependencies.php index ea607de2c..de3630ad8 100644 --- a/wp-includes/class.wp-dependencies.php +++ b/wp-includes/class.wp-dependencies.php @@ -37,11 +37,11 @@ class WP_Dependencies { * * Process the items passed to it or the queue. Processes all dependencies. * - * @param mixed handles (optional) items to be processed. (void) processes queue, (string) process that item, (array of strings) process those items + * @param mixed $handles (optional) items to be processed. (void) processes queue, (string) process that item, (array of strings) process those items * @return array Items that have been processed */ function do_items( $handles = false, $group = false ) { - // Print the queue if nothing is passed. If a string is passed, print that script. If an array is passed, print those scripts. + // Print the queue if nothing is passed. If a string is passed, print that script. If an array is passed, print those scripts. $handles = false === $handles ? $this->queue : (array) $handles; $this->all_deps( $handles ); @@ -72,9 +72,9 @@ class WP_Dependencies { * * Recursively builds array of items to process taking dependencies into account. Does NOT catch infinite loops. * - - * @param mixed handles Accepts (string) dep name or (array of strings) dep names - * @param bool recursion Used internally when function calls itself + * + * @param mixed $handles Accepts (string) dep name or (array of strings) dep names + * @param bool $recursion Used internally when function calls itself */ function all_deps( $handles, $recursion = false, $group = false ) { if ( !$handles = (array) $handles ) @@ -125,10 +125,10 @@ class WP_Dependencies { * * Adds the item only if no item of that name already exists * - * @param string handle Script name - * @param string src Script url - * @param array deps (optional) Array of script names on which this script depends - * @param string ver (optional) Script version (used for cache busting) + * @param string $handle Script name + * @param string $src Script url + * @param array $deps (optional) Array of script names on which this script depends + * @param string $ver (optional) Script version (used for cache busting) * @return array Hierarchical array of dependencies */ function add( $handle, $src, $deps = array(), $ver = false, $args = null ) { @@ -143,9 +143,9 @@ class WP_Dependencies { * * Adds data only if script has already been added * - * @param string handle Script name - * @param string data_name Name of object in which to store extra data - * @param array data Array of extra data + * @param string $handle Script name + * @param string $data_name Name of object in which to store extra data + * @param array $data Array of extra data * @return bool success */ function add_data( $handle, $data_name, $data ) { diff --git a/wp-includes/class.wp-scripts.php b/wp-includes/class.wp-scripts.php index 9ba2fcc42..681a82469 100644 --- a/wp-includes/class.wp-scripts.php +++ b/wp-includes/class.wp-scripts.php @@ -39,8 +39,8 @@ class WP_Scripts extends WP_Dependencies { * * Prints the scripts passed to it or the print queue. Also prints all necessary dependencies. * - * @param mixed handles (optional) Scripts to be printed. (void) prints queue, (string) prints that script, (array of strings) prints those scripts. - * @param int group (optional) If scripts were queued in groups prints this group number. + * @param mixed $handles (optional) Scripts to be printed. (void) prints queue, (string) prints that script, (array of strings) prints those scripts. + * @param int $group (optional) If scripts were queued in groups prints this group number. * @return array Scripts that have been printed */ function print_scripts( $handles = false, $group = false ) { @@ -135,9 +135,9 @@ class WP_Scripts extends WP_Dependencies { * * Localizes only if script has already been added * - * @param string handle Script name - * @param string object_name Name of JS object to hold l10n info - * @param array l10n Array of JS var name => localized string + * @param string $handle Script name + * @param string $object_name Name of JS object to hold l10n info + * @param array $l10n Array of JS var name => localized string * @return bool Successful localization */ function localize( $handle, $object_name, $l10n ) { diff --git a/wp-includes/formatting.php b/wp-includes/formatting.php index b5d690c7b..04ed7f974 100644 --- a/wp-includes/formatting.php +++ b/wp-includes/formatting.php @@ -1577,7 +1577,7 @@ function wp_iso_descrambler($string) { * * @since 3.1.0 * @access private - * @param $match the preg_replace_callback matches array + * @param array $match the preg_replace_callback matches array */ function _wp_iso_convert( $match ) { return chr( hexdec( strtolower( $match[1] ) ) ); diff --git a/wp-includes/functions.php b/wp-includes/functions.php index e0a663a80..ea6413643 100644 --- a/wp-includes/functions.php +++ b/wp-includes/functions.php @@ -4360,8 +4360,8 @@ function _wp_mysql_week( $column ) { * @access private * * @param callback $callback function that accepts ( ID, $callback_args ) and outputs parent_ID - * @param $start The ID to start the loop check at - * @param $start_parent the parent_ID of $start to use instead of calling $callback( $start ). Use null to always use $callback + * @param int $start The ID to start the loop check at + * @param int $start_parent the parent_ID of $start to use instead of calling $callback( $start ). Use null to always use $callback * @param array $callback_args optional additional arguments to send to $callback * @return array IDs of all members of loop */ @@ -4384,7 +4384,7 @@ function wp_find_hierarchy_loop( $callback, $start, $start_parent, $callback_arg * @access private * * @param callback $callback function that accupts ( ID, callback_arg, ... ) and outputs parent_ID - * @param $start The ID to start the loop check at + * @param int $start The ID to start the loop check at * @param array $override an array of ( ID => parent_ID, ... ) to use instead of $callback * @param array $callback_args optional additional arguments to send to $callback * @param bool $_return_loop Return loop members or just detect presence of loop? diff --git a/wp-includes/ms-blogs.php b/wp-includes/ms-blogs.php index 7eed68065..b24a3865c 100644 --- a/wp-includes/ms-blogs.php +++ b/wp-includes/ms-blogs.php @@ -664,13 +664,17 @@ function get_blog_status( $id, $pref ) { * * @since MU * - * @param $deprecated Not used + * @param mixed $deprecated Not used * @param int $start The offset * @param int $quantity The maximum number of blogs to retrieve. Default is 40. * @return array The list of blogs */ function get_last_updated( $deprecated = '', $start = 0, $quantity = 40 ) { global $wpdb; + + if ( ! empty( $deprecated ) ) + _deprecated_argument( __FUNCTION__, 'MU' ); // never used + return $wpdb->get_results( $wpdb->prepare("SELECT blog_id, domain, path FROM $wpdb->blogs WHERE site_id = %d AND public = '1' AND archived = '0' AND mature = '0' AND spam = '0' AND deleted = '0' AND last_updated != '0000-00-00 00:00:00' ORDER BY last_updated DESC limit %d, %d", $wpdb->siteid, $start, $quantity ) , ARRAY_A ); } diff --git a/wp-includes/post-template.php b/wp-includes/post-template.php index 1d0e39e03..6dffb4d0d 100644 --- a/wp-includes/post-template.php +++ b/wp-includes/post-template.php @@ -675,7 +675,7 @@ function wp_link_pages($args = '') { * @since 3.1.0 * @access private * - * @param $i Page number. + * @param int $i Page number. * @return string Link. */ function _wp_link_page( $i ) { diff --git a/wp-includes/post.php b/wp-includes/post.php index fbc6455e9..4fcc44991 100644 --- a/wp-includes/post.php +++ b/wp-includes/post.php @@ -5042,7 +5042,8 @@ function wp_check_post_hierarchy_for_loops( $post_parent, $post_ID ) { * * @since 2.0.0 * - * @param string A post type string, defaults to 'post'. + * @param string $post_type A post type string, defaults to 'post'. + * @param bool $create_in_db If true then also insert an auto-draft into database * @return object stdClass object containing all the default post data as attributes */ function get_default_post_to_edit( $post_type = 'post', $create_in_db = false ) {