diff --git a/wp-admin/includes/class-wp-upgrader.php b/wp-admin/includes/class-wp-upgrader.php index d45c72f8a4..cf33046f6e 100644 --- a/wp-admin/includes/class-wp-upgrader.php +++ b/wp-admin/includes/class-wp-upgrader.php @@ -348,7 +348,7 @@ class WP_Upgrader { * * @param array $nested_files Array of files as returned by WP_Filesystem::dirlist() * @param string $path Relative path to prepend to child nodes. Optional. - * @return array $files A flattened array of the $nested_files specified. + * @return array A flattened array of the $nested_files specified. */ protected function flatten_dirlist( $nested_files, $path = '' ) { $files = array(); diff --git a/wp-admin/includes/deprecated.php b/wp-admin/includes/deprecated.php index ec5c7f7c2a..5df3b87403 100644 --- a/wp-admin/includes/deprecated.php +++ b/wp-admin/includes/deprecated.php @@ -1001,7 +1001,7 @@ function add_contextual_help( $screen, $help ) { * @deprecated 3.4.0 Use wp_get_themes() * @see wp_get_themes() * - * @return array $themes Array of allowed themes. + * @return WP_Theme[] Array of WP_Theme objects keyed by their name. */ function get_allowed_themes() { _deprecated_function( __FUNCTION__, '3.4.0', "wp_get_themes( array( 'allowed' => true ) )" ); diff --git a/wp-admin/includes/image.php b/wp-admin/includes/image.php index a0f78ed3db..a22bf124e9 100644 --- a/wp-admin/includes/image.php +++ b/wp-admin/includes/image.php @@ -244,7 +244,12 @@ function wp_create_image_subsizes( $file, $attachment_id ) { * @since 5.3.0 * * @param int $threshold The threshold value in pixels. Default 2560. - * @param array $imagesize Indexed array of the image width and height (in that order). + * @param array $imagesize { + * Indexed array of the image width and height in pixels. + * + * @type int $0 The image width. + * @type int $0 The image height. + * } * @param string $file Full path to the uploaded image file. * @param int $attachment_id Attachment post ID. */ @@ -535,8 +540,8 @@ function wp_generate_attachment_metadata( $attachment_id, $file ) { * * @since 4.7.0 * - * @param array $fallback_sizes An array of image size names. - * @param array $metadata Current attachment metadata. + * @param string[] $fallback_sizes An array of image size names. + * @param array $metadata Current attachment metadata. */ $fallback_sizes = apply_filters( 'fallback_intermediate_image_sizes', $fallback_sizes, $metadata ); diff --git a/wp-admin/includes/nav-menu.php b/wp-admin/includes/nav-menu.php index cb0bbe6449..d10ce01594 100644 --- a/wp-admin/includes/nav-menu.php +++ b/wp-admin/includes/nav-menu.php @@ -1126,7 +1126,7 @@ function _wp_delete_orphaned_draft_menu_items() { * * @param int|string $nav_menu_selected_id (id, slug, or name ) of the currently-selected menu * @param string $nav_menu_selected_title Title of the currently-selected menu - * @return array $messages The menu updated message + * @return array The menu updated message */ function wp_nav_menu_update_menu_items( $nav_menu_selected_id, $nav_menu_selected_title ) { $unsorted_menu_items = wp_get_nav_menu_items( diff --git a/wp-includes/class-wp-customize-widgets.php b/wp-includes/class-wp-customize-widgets.php index 1a0ae316e9..297342238a 100644 --- a/wp-includes/class-wp-customize-widgets.php +++ b/wp-includes/class-wp-customize-widgets.php @@ -1104,7 +1104,7 @@ final class WP_Customize_Widgets { * @since 4.2.0 * * @param array $nonces Array of nonces. - * @return array $nonces Array of nonces. + * @return array Array of nonces. */ public function refresh_nonces( $nonces ) { $nonces['update-widget'] = wp_create_nonce( 'update-widget' ); diff --git a/wp-includes/comment.php b/wp-includes/comment.php index 7837ce94a9..78413c3c3e 100644 --- a/wp-includes/comment.php +++ b/wp-includes/comment.php @@ -3393,7 +3393,7 @@ function wp_handle_comment_submission( $comment_data ) { * @since 4.9.6 * * @param array $exporters An array of personal data exporters. - * @return array $exporters An array of personal data exporters. + * @return array An array of personal data exporters. */ function wp_register_comment_personal_data_exporter( $exporters ) { $exporters['wordpress-comments'] = array( @@ -3411,7 +3411,7 @@ function wp_register_comment_personal_data_exporter( $exporters ) { * * @param string $email_address The comment author email address. * @param int $page Comment page. - * @return array $return An array of personal data. + * @return array An array of personal data. */ function wp_comments_personal_data_exporter( $email_address, $page = 1 ) { // Limit us to 500 comments at a time to avoid timing out. @@ -3503,7 +3503,7 @@ function wp_comments_personal_data_exporter( $email_address, $page = 1 ) { * @since 4.9.6 * * @param array $erasers An array of personal data erasers. - * @return array $erasers An array of personal data erasers. + * @return array An array of personal data erasers. */ function wp_register_comment_personal_data_eraser( $erasers ) { $erasers['wordpress-comments'] = array( diff --git a/wp-includes/embed.php b/wp-includes/embed.php index 06092b4388..8472ca7368 100644 --- a/wp-includes/embed.php +++ b/wp-includes/embed.php @@ -76,8 +76,12 @@ function wp_embed_defaults( $url = '' ) { * * @since 2.9.0 * - * @param array $size An array of embed width and height values - * in pixels (in that order). + * @param array $size { + * Indexed array of the embed width and height in pixels. + * + * @type int $0 The embed width. + * @type int $0 The embed height. + * } * @param string $url The URL that should be embedded. */ return apply_filters( 'embed_defaults', compact( 'width', 'height' ), $url ); diff --git a/wp-includes/functions.php b/wp-includes/functions.php index 47ee58a3ad..995268fd41 100644 --- a/wp-includes/functions.php +++ b/wp-includes/functions.php @@ -6395,7 +6395,7 @@ function wp_auth_check_html() { * @global int $login_grace_period * * @param array $response The Heartbeat response. - * @return array $response The Heartbeat response with 'wp-auth-check' value set. + * @return array The Heartbeat response with 'wp-auth-check' value set. */ function wp_auth_check( $response ) { $response['wp-auth-check'] = is_user_logged_in() && empty( $GLOBALS['login_grace_period'] ); diff --git a/wp-includes/media.php b/wp-includes/media.php index 90727be7a9..4ead3ab8cd 100644 --- a/wp-includes/media.php +++ b/wp-includes/media.php @@ -1107,8 +1107,7 @@ function _wp_get_attachment_relative_path( $file ) { * * @param string $size_name Image size. Accepts any valid image size name ('thumbnail', 'medium', etc.). * @param array $image_meta The image meta data. - * @return array|bool Array of width and height values in pixels (in that order) - * or false if the size doesn't exist. + * @return array|bool The image meta data as returned by `wp_get_attachment_metadata()`. */ function _wp_get_image_size_from_meta( $size_name, $image_meta ) { if ( $size_name === 'full' ) { diff --git a/wp-includes/ms-functions.php b/wp-includes/ms-functions.php index 99a5533dc2..a87f44175a 100644 --- a/wp-includes/ms-functions.php +++ b/wp-includes/ms-functions.php @@ -2577,7 +2577,7 @@ function wp_is_large_network( $using = 'sites', $network_id = null ) { * * @since 4.4.0 * - * @return array $names Array of reserved subdirectory names. + * @return array Array of reserved subdirectory names. */ function get_subdirectory_reserved_names() { $names = array( diff --git a/wp-includes/rest-api.php b/wp-includes/rest-api.php index 417b8ddada..ae4f609ac0 100644 --- a/wp-includes/rest-api.php +++ b/wp-includes/rest-api.php @@ -1165,7 +1165,7 @@ function rest_is_boolean( $maybe_bool ) { * * @param mixed $id_or_email The Gravatar to retrieve a URL for. Accepts a user_id, gravatar md5 hash, * user email, WP_User object, WP_Post object, or WP_Comment object. - * @return array $urls Gravatar url for each size. + * @return array Gravatar url for each size. */ function rest_get_avatar_urls( $id_or_email ) { $avatar_sizes = rest_get_avatar_sizes(); diff --git a/wp-includes/version.php b/wp-includes/version.php index 281173c407..e07496a007 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -13,7 +13,7 @@ * * @global string $wp_version */ -$wp_version = '5.4-alpha-46643'; +$wp_version = '5.4-alpha-46644'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.