diff --git a/src/wp-admin/includes/class-wp-media-list-table.php b/src/wp-admin/includes/class-wp-media-list-table.php index cc8940a6cb..5934585b50 100644 --- a/src/wp-admin/includes/class-wp-media-list-table.php +++ b/src/wp-admin/includes/class-wp-media-list-table.php @@ -658,7 +658,6 @@ class WP_Media_List_Table extends WP_List_Table { /** * @param WP_Post $post * @param string $att_title - * * @return array */ private function _get_row_actions( $post, $att_title ) { diff --git a/src/wp-admin/includes/class-wp-site-health.php b/src/wp-admin/includes/class-wp-site-health.php index ebb7937155..7f69cca53c 100644 --- a/src/wp-admin/includes/class-wp-site-health.php +++ b/src/wp-admin/includes/class-wp-site-health.php @@ -148,7 +148,6 @@ class WP_Site_Health { * @since 5.4.0 * * @param $callback - * * @return mixed|void */ private function perform_test( $callback ) { @@ -790,7 +789,6 @@ class WP_Site_Health { * @param string $function Optional. The function name to test. Default null. * @param string $constant Optional. The constant name to test for. Default null. * @param string $class Optional. The class name to test for. Default null. - * * @return bool Whether or not the extension and function are available. */ private function test_php_extension_availability( $extension = null, $function = null, $constant = null, $class = null ) { diff --git a/src/wp-admin/includes/comment.php b/src/wp-admin/includes/comment.php index 4571cd4b76..3f0a2974dc 100644 --- a/src/wp-admin/includes/comment.php +++ b/src/wp-admin/includes/comment.php @@ -21,7 +21,6 @@ * @param string $comment_author Author of the comment. * @param string $comment_date Date of the comment. * @param string $timezone Timezone. Accepts 'blog' or 'gmt'. Default 'blog'. - * * @return mixed Comment post ID on success. */ function comment_exists( $comment_author, $comment_date, $timezone = 'blog' ) { diff --git a/src/wp-admin/includes/file.php b/src/wp-admin/includes/file.php index a483046128..b06b632c73 100644 --- a/src/wp-admin/includes/file.php +++ b/src/wp-admin/includes/file.php @@ -1976,7 +1976,6 @@ function get_filesystem_method( $args = array(), $context = '', $allow_relaxed_f * @param array $extra_fields Optional. Extra `POST` fields to be checked for inclusion in * the post. Default null. * @param bool $allow_relaxed_file_ownership Optional. Whether to allow Group/World writable. Default false. - * * @return bool|array True if no filesystem credentials are required, false if they are required but have not been * provided, array of credentials if they are required and have been provided. */ diff --git a/src/wp-admin/includes/misc.php b/src/wp-admin/includes/misc.php index f6e5d68f6d..d2103f45b7 100644 --- a/src/wp-admin/includes/misc.php +++ b/src/wp-admin/includes/misc.php @@ -1401,7 +1401,6 @@ All at ###SITENAME### * * @param string $title Page title. * @param WP_Post $page Page data object. - * * @return string Page title. */ function _wp_privacy_settings_filter_draft_page_titles( $title, $page ) { diff --git a/src/wp-admin/includes/revision.php b/src/wp-admin/includes/revision.php index ac4f7de00e..52600dce06 100644 --- a/src/wp-admin/includes/revision.php +++ b/src/wp-admin/includes/revision.php @@ -15,7 +15,6 @@ * @param WP_Post|int $post The post object or post ID. * @param int $compare_from The revision ID to compare from. * @param int $compare_to The revision ID to come to. - * * @return array|bool Associative array of a post's revisioned fields and their diffs. * Or, false on failure. */ @@ -161,7 +160,6 @@ function wp_get_revision_ui_diff( $post, $compare_from, $compare_to ) { * @param WP_Post|int $post The post object or post ID. * @param int $selected_revision_id The selected revision ID. * @param int $from Optional. The revision ID to compare from. - * * @return array An associative array of revision data and related settings. */ function wp_prepare_revisions_for_js( $post, $selected_revision_id, $from = null ) { diff --git a/src/wp-content/themes/twentynineteen/inc/customizer.php b/src/wp-content/themes/twentynineteen/inc/customizer.php index 58e996c2a7..ea093d23ce 100644 --- a/src/wp-content/themes/twentynineteen/inc/customizer.php +++ b/src/wp-content/themes/twentynineteen/inc/customizer.php @@ -141,7 +141,6 @@ add_action( 'customize_controls_enqueue_scripts', 'twentynineteen_panels_js' ); * Sanitize custom color choice. * * @param string $choice Whether image filter is active. - * * @return string */ function twentynineteen_sanitize_color_option( $choice ) { diff --git a/src/wp-content/themes/twentyseventeen/functions.php b/src/wp-content/themes/twentyseventeen/functions.php index 4c1a1ecf89..ee03607d2a 100644 --- a/src/wp-content/themes/twentyseventeen/functions.php +++ b/src/wp-content/themes/twentyseventeen/functions.php @@ -589,8 +589,8 @@ add_filter( 'wp_get_attachment_image_attributes', 'twentyseventeen_post_thumbnai * @since Twenty Seventeen 1.0 * * @param string $template front-page.php. - * - * @return string The template to be used: blank if is_home() is true (defaults to index.php), else $template. + * @return string The template to be used: blank if is_home() is true (defaults to index.php), + * otherwise $template. */ function twentyseventeen_front_page_template( $template ) { return is_home() ? '' : $template; @@ -617,7 +617,7 @@ function twentyseventeen_widget_tag_cloud_args( $args ) { add_filter( 'widget_tag_cloud_args', 'twentyseventeen_widget_tag_cloud_args' ); /** - * Get unique ID. + * Gets unique ID. * * This is a PHP implementation of Underscore's uniqueId method. A static variable * contains an integer that is incremented with each call. This number is returned diff --git a/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-customize.php b/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-customize.php index ff7c70c2fa..992a01d92b 100644 --- a/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-customize.php +++ b/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-customize.php @@ -416,7 +416,7 @@ if ( ! class_exists( 'TwentyTwenty_Customize' ) ) { * @access public * @since Twenty Twenty 1.0 * @param array $value The value we want to sanitize. - * @return array Returns sanitized value. Each item in the array gets sanitized separately. + * @return array Returns sanitized value. Each item in the array gets sanitized separately. */ public static function sanitize_accent_accessible_colors( $value ) { @@ -438,8 +438,7 @@ if ( ! class_exists( 'TwentyTwenty_Customize' ) ) { * * @param string $input The input from the setting. * @param object $setting The selected setting. - * - * @return string $input|$setting->default The input from the setting or the default setting. + * @return string The input from the setting or the default setting. */ public static function sanitize_select( $input, $setting ) { $input = sanitize_key( $input ); @@ -451,7 +450,6 @@ if ( ! class_exists( 'TwentyTwenty_Customize' ) ) { * Sanitize boolean for checkbox. * * @param bool $checked Whether or not a box is checked. - * * @return bool */ public static function sanitize_checkbox( $checked ) { diff --git a/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-non-latin-languages.php b/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-non-latin-languages.php index df95c56a37..7fd444317d 100644 --- a/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-non-latin-languages.php +++ b/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-non-latin-languages.php @@ -21,7 +21,6 @@ if ( ! class_exists( 'TwentyTwenty_Non_Latin_Languages' ) ) { * Return CSS for non-latin language, if available, or null * * @param string $type Whether to return CSS for the "front-end", "block-editor" or "classic-editor". - * * @return void */ public static function get_non_latin_css( $type = 'front-end' ) { diff --git a/src/wp-content/themes/twentytwenty/functions.php b/src/wp-content/themes/twentytwenty/functions.php index 278fd7e488..8f7826dd98 100644 --- a/src/wp-content/themes/twentytwenty/functions.php +++ b/src/wp-content/themes/twentytwenty/functions.php @@ -271,8 +271,7 @@ add_action( 'init', 'twentytwenty_menus' ); * Get the information about the logo. * * @param string $html The HTML output from get_custom_logo (core function). - * - * @return string $html + * @return string */ function twentytwenty_get_custom_logo( $html ) { @@ -427,8 +426,7 @@ add_action( 'init', 'twentytwenty_classic_editor_styles' ); * Adds styles to the head of the TinyMCE iframe. Kudos to @Otto42 for the original solution. * * @param array $mce_init TinyMCE styles. - * - * @return array $mce_init TinyMCE styles. + * @return array TinyMCE styles. */ function twentytwenty_add_classic_editor_customizer_styles( $mce_init ) { @@ -451,8 +449,7 @@ add_filter( 'tiny_mce_before_init', 'twentytwenty_add_classic_editor_customizer_ * Adds styles to the head of the TinyMCE iframe. Kudos to @Otto42 for the original solution. * * @param array $mce_init TinyMCE styles. - * - * @return array $mce_init TinyMCE styles. + * @return array TinyMCE styles. */ function twentytwenty_add_classic_editor_non_latin_styles( $mce_init ) { @@ -569,8 +566,7 @@ add_action( 'after_setup_theme', 'twentytwenty_block_editor_settings' ); * Overwrite default more tag with styling and screen reader markup. * * @param string $html The default output HTML for the more tag. - * - * @return string $html + * @return string */ function twentytwenty_read_more_tag( $html ) { return preg_replace( '/(.*)<\/a>/iU', sprintf( '
$2 "%1$s"
', get_the_title( get_the_ID() ) ), $html ); diff --git a/src/wp-content/themes/twentytwenty/inc/starter-content.php b/src/wp-content/themes/twentytwenty/inc/starter-content.php index 08f91c0551..95f7bc57aa 100644 --- a/src/wp-content/themes/twentytwenty/inc/starter-content.php +++ b/src/wp-content/themes/twentytwenty/inc/starter-content.php @@ -15,7 +15,8 @@ * Passes it through the `twentytwenty_starter_content` filter before returning. * * @since Twenty Twenty 1.0 - * @return array a filtered array of args for the starter_content. + * + * @return array A filtered array of args for the starter_content. */ function twentytwenty_get_starter_content() { diff --git a/src/wp-content/themes/twentytwenty/inc/template-tags.php b/src/wp-content/themes/twentytwenty/inc/template-tags.php index 1f09b966a9..759b86695a 100644 --- a/src/wp-content/themes/twentytwenty/inc/template-tags.php +++ b/src/wp-content/themes/twentytwenty/inc/template-tags.php @@ -21,13 +21,13 @@ /** * Logo & Description */ + /** * Displays the site logo, either text or image. * * @param array $args Arguments for displaying the site logo either as an image or text. * @param boolean $echo Echo or return the HTML. - * - * @return string $html Compiled HTML based on our arguments. + * @return string Compiled HTML based on our arguments. */ function twentytwenty_site_logo( $args = array(), $echo = true ) { $logo = get_custom_logo(); @@ -89,8 +89,7 @@ function twentytwenty_site_logo( $args = array(), $echo = true ) { * Displays the site description. * * @param boolean $echo Echo or return the html. - * - * @return string $html The HTML to display. + * @return string The HTML to display. */ function twentytwenty_site_description( $echo = true ) { $description = get_bloginfo( 'description' ); @@ -124,11 +123,11 @@ function twentytwenty_site_description( $echo = true ) { /** * Comments */ + /** - * Check if the specified comment is written by the author of the post commented on. + * Checks if the specified comment is written by the author of the post commented on. * * @param object $comment Comment data. - * * @return bool */ function twentytwenty_is_comment_by_post_author( $comment = null ) { @@ -149,13 +148,13 @@ function twentytwenty_is_comment_by_post_author( $comment = null ) { } /** - * Filter comment reply link to not JS scroll. + * Filters comment reply link to not JS scroll. + * * Filter the comment reply link to add a class indicating it should not use JS slow-scroll, as it * makes it scroll to the wrong position on the page. * * @param string $link Link to the top of the page. - * - * @return string $link Link to the top of the page. + * @return string Link to the top of the page. */ function twentytwenty_filter_comment_reply_link( $link ) { @@ -169,11 +168,13 @@ add_filter( 'comment_reply_link', 'twentytwenty_filter_comment_reply_link' ); /** * Post Meta */ + /** - * Get and Output Post Meta. - * If it's a single post, output the post meta values specified in the Customizer settings. + * Retrieves and displays the post meta. * - * @param int $post_id The ID of the post for which the post meta should be output. + * If it's a single post, outputs the post meta values specified in the Customizer settings. + * + * @param int $post_id The ID of the post for which the post meta should be output. * @param string $location Which post meta location to output – single or preview. */ function twentytwenty_the_post_meta( $post_id = null, $location = 'single-top' ) { @@ -220,7 +221,7 @@ function twentytwenty_edit_post_link( $link, $post_id, $text ) { add_filter( 'edit_post_link', 'twentytwenty_edit_post_link', 10, 3 ); /** - * Get the post meta. + * Retrieves the post meta. * * @param int $post_id The ID of the post. * @param string $location The location where the meta is shown. @@ -233,15 +234,17 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' ) } /** - * Filters post types array + * Filters post types array. * - * This filter can be used to hide post meta information of post, page or custom post type registerd by child themes or plugins + * This filter can be used to hide post meta information of post, page or custom post type + * registered by child themes or plugins. * * @since Twenty Twenty 1.0 * * @param array Array of post types */ $disallowed_post_types = apply_filters( 'twentytwenty_disallowed_post_types_for_meta_output', array( 'page' ) ); + // Check whether the post type is allowed to output post meta. if ( in_array( get_post_type( $post_id ), $disallowed_post_types, true ) ) { return; @@ -253,19 +256,19 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' ) // Get the post meta settings for the location specified. if ( 'single-top' === $location ) { /** - * Filters post meta info visibility - * - * Use this filter to hide post meta information like Author, Post date, Comments, Is sticky status - * - * @since Twenty Twenty 1.0 - * - * @param array $args { - * @type string 'author' - * @type string 'post-date' - * @type string 'comments' - * @type string 'sticky' - * } - */ + * Filters post meta info visibility. + * + * Use this filter to hide post meta information like Author, Post date, Comments, Is sticky status. + * + * @since Twenty Twenty 1.0 + * + * @param array $args { + * @type string 'author' + * @type string 'post-date' + * @type string 'comments' + * @type string 'sticky' + * } + */ $post_meta = apply_filters( 'twentytwenty_post_meta_location_single_top', array( @@ -281,16 +284,16 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' ) } elseif ( 'single-bottom' === $location ) { /** - * Filters post tags visibility - * - * Use this filter to hide post tags - * - * @since Twenty Twenty 1.0 - * - * @param array $args { - * @type string 'tags' - * } - */ + * Filters post tags visibility. + * + * Use this filter to hide post tags. + * + * @since Twenty Twenty 1.0 + * + * @param array $args { + * @type string 'tags' + * } + */ $post_meta = apply_filters( 'twentytwenty_post_meta_location_single_bottom', array( @@ -489,8 +492,10 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' ) /** * Menus */ + /** - * Filter Classes of wp_list_pages items to match menu items. + * Filters classes of wp_list_pages items to match menu items. + * * Filter the class applied to wp_list_pages() items with children to match the menu class, to simplify. * styling of sub levels in the fallback. Only applied if the match_menu_classes argument is set. * @@ -499,7 +504,6 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' ) * @param int $depth Depth of the current comment. * @param array $args An array of arguments. * @param string $current_page Whether or not the item is the current item. - * * @return array $css_class CSS Class names. */ function twentytwenty_filter_wp_list_pages_item_classes( $css_class, $item, $depth, $args, $current_page ) { @@ -528,12 +532,11 @@ function twentytwenty_filter_wp_list_pages_item_classes( $css_class, $item, $dep add_filter( 'page_css_class', 'twentytwenty_filter_wp_list_pages_item_classes', 10, 5 ); /** - * Add a Sub Nav Toggle to the Expanded Menu and Mobile Menu. + * Adds a Sub Nav Toggle to the Expanded Menu and Mobile Menu. * * @param stdClass $args An array of arguments. * @param string $item Menu item. * @param int $depth Depth of the current menu item. - * * @return stdClass $args An object of wp_nav_menu() arguments. */ function twentytwenty_add_sub_toggles_to_main_menu( $args, $item, $depth ) { @@ -575,7 +578,7 @@ function twentytwenty_add_sub_toggles_to_main_menu( $args, $item, $depth ) { add_filter( 'nav_menu_item_args', 'twentytwenty_add_sub_toggles_to_main_menu', 10, 3 ); /** - * Display SVG icons in social links menu. + * Displays SVG icons in social links menu. * * @param string $item_output The menu item output. * @param WP_Post $item Menu item object. @@ -601,9 +604,11 @@ add_filter( 'walker_nav_menu_start_el', 'twentytwenty_nav_menu_social_icons', 10 /** * Classes */ + /** - * Add No-JS Class. - * If we're missing JavaScript support, the HTML element will have a no-js class. + * Adds 'no-js' class. + * + * If we're missing JavaScript support, the HTML element will have a 'no-js' class. */ function twentytwenty_no_js_class() { @@ -616,11 +621,10 @@ function twentytwenty_no_js_class() { add_action( 'wp_head', 'twentytwenty_no_js_class' ); /** - * Add conditional body classes. + * Adds conditional body classes. * * @param array $classes Classes added to the body tag. - * - * @return array $classes Classes added to the body tag. + * @return array Classes added to the body tag. */ function twentytwenty_body_classes( $classes ) { @@ -716,12 +720,12 @@ add_filter( 'body_class', 'twentytwenty_body_classes' ); /** * Archives */ + /** * Filters the archive title and styles the word before the first colon. * * @param string $title Current archive title. - * - * @return string $title Current archive title. + * @return string Current archive title. */ function twentytwenty_get_the_archive_title( $title ) { @@ -748,10 +752,11 @@ add_filter( 'get_the_archive_title', 'twentytwenty_get_the_archive_title' ); /** * Miscellaneous */ + /** - * Toggle animation duration in milliseconds. + * Toggles animation duration in milliseconds. * - * @return integer Duration in milliseconds + * @return int Duration in milliseconds */ function twentytwenty_toggle_duration() { /** @@ -759,7 +764,7 @@ function twentytwenty_toggle_duration() { * * @since Twenty Twenty 1.0 * - * @param integer $duration Duration in milliseconds. + * @param int $duration Duration in milliseconds. */ $duration = apply_filters( 'twentytwenty_toggle_duration', 250 ); @@ -767,7 +772,7 @@ function twentytwenty_toggle_duration() { } /** - * Get unique ID. + * Gets unique ID. * * This is a PHP implementation of Underscore's uniqueId method. A static variable * contains an integer that is incremented with each call. This number is returned diff --git a/src/wp-includes/blocks.php b/src/wp-includes/blocks.php index 2e675f1bae..3769b936cd 100644 --- a/src/wp-includes/blocks.php +++ b/src/wp-includes/blocks.php @@ -589,8 +589,9 @@ function block_version( $content ) { * @since 5.3.0 * * @param string $block_name Block type name including namespace. - * @param array $style_properties Array containing the properties of the style name, label, style (name of the stylesheet to be enqueued), inline_style (string containing the CSS to be added). - * + * @param array $style_properties Array containing the properties of the style name, + * label, style (name of the stylesheet to be enqueued), + * inline_style (string containing the CSS to be added). * @return boolean True if the block style was registered with success and false otherwise. */ function register_block_style( $block_name, $style_properties ) { @@ -604,7 +605,6 @@ function register_block_style( $block_name, $style_properties ) { * * @param string $block_name Block type name including namespace. * @param array $block_style_name Block style name. - * * @return boolean True if the block style was unregistered with success and false otherwise. */ function unregister_block_style( $block_name, $block_style_name ) { diff --git a/src/wp-includes/class-http.php b/src/wp-includes/class-http.php index 5260fcf7ba..1a37ee9dad 100644 --- a/src/wp-includes/class-http.php +++ b/src/wp-includes/class-http.php @@ -511,7 +511,6 @@ class WP_Http { * * @param array $args Request arguments. * @param string $url URL to Request. - * * @return string|false Class name for the first transport that claims to support the request. * False if no transport claims to support the request. */ diff --git a/src/wp-includes/class-wp-date-query.php b/src/wp-includes/class-wp-date-query.php index 95346d45e4..90e80afdd9 100644 --- a/src/wp-includes/class-wp-date-query.php +++ b/src/wp-includes/class-wp-date-query.php @@ -177,14 +177,12 @@ class WP_Date_Query { * Recursive-friendly query sanitizer. * * Ensures that each query-level clause has a 'relation' key, and that - * each first-order clause contains all the necessary keys from - * `$defaults`. + * each first-order clause contains all the necessary keys from `$defaults`. * * @since 4.1.0 * * @param array $queries * @param array $parent_query - * * @return array Sanitized queries. */ public function sanitize_query( $queries, $parent_query = null ) { diff --git a/src/wp-includes/class-wp-image-editor-imagick.php b/src/wp-includes/class-wp-image-editor-imagick.php index ea2c48eb4d..c14bc9f2b4 100644 --- a/src/wp-includes/class-wp-image-editor-imagick.php +++ b/src/wp-includes/class-wp-image-editor-imagick.php @@ -209,7 +209,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor { * * @param int $width * @param int $height - * * @return true|WP_Error */ protected function update_size( $width = null, $height = null ) { diff --git a/src/wp-includes/class-wp-network-query.php b/src/wp-includes/class-wp-network-query.php index 61651cae40..24928bd436 100644 --- a/src/wp-includes/class-wp-network-query.php +++ b/src/wp-includes/class-wp-network-query.php @@ -509,7 +509,6 @@ class WP_Network_Query { * * @param string $string Search string. * @param string[] $columns Array of columns to search. - * * @return string Search SQL. */ protected function get_search_sql( $string, $columns ) { diff --git a/src/wp-includes/class-wp-paused-extensions-storage.php b/src/wp-includes/class-wp-paused-extensions-storage.php index 993ab060e0..477b26ec7d 100644 --- a/src/wp-includes/class-wp-paused-extensions-storage.php +++ b/src/wp-includes/class-wp-paused-extensions-storage.php @@ -80,7 +80,6 @@ class WP_Paused_Extensions_Storage { * @since 5.2.0 * * @param string $extension Plugin or theme directory name. - * * @return bool True on success, false on failure. */ public function delete( $extension ) { @@ -121,7 +120,6 @@ class WP_Paused_Extensions_Storage { * @since 5.2.0 * * @param string $extension Plugin or theme directory name. - * * @return array|null Error that is stored, or null if the extension is not paused. */ public function get( $extension ) { diff --git a/src/wp-includes/class-wp-recovery-mode-email-service.php b/src/wp-includes/class-wp-recovery-mode-email-service.php index 9ef935300c..ebf5e050c4 100644 --- a/src/wp-includes/class-wp-recovery-mode-email-service.php +++ b/src/wp-includes/class-wp-recovery-mode-email-service.php @@ -101,7 +101,6 @@ final class WP_Recovery_Mode_Email_Service { * @param int $rate_limit Number of seconds before another email can be sent. * @param array $error Error details from {@see error_get_last()} * @param array $extension Extension that caused the error. - * * @return bool Whether the email was sent successfully. */ private function send_recovery_mode_email( $rate_limit, $error, $extension ) { diff --git a/src/wp-includes/class-wp-recovery-mode.php b/src/wp-includes/class-wp-recovery-mode.php index 1ca96072ed..1491618def 100644 --- a/src/wp-includes/class-wp-recovery-mode.php +++ b/src/wp-includes/class-wp-recovery-mode.php @@ -340,7 +340,6 @@ class WP_Recovery_Mode { * @global array $wp_theme_directories * * @param array $error Error that was triggered. - * * @return array|false { * @type string $slug The extension slug. This is the plugin or theme's directory. * @type string $type The extension type. Either 'plugin' or 'theme'. diff --git a/src/wp-includes/compat.php b/src/wp-includes/compat.php index 0fc58981dd..ddb372468a 100644 --- a/src/wp-includes/compat.php +++ b/src/wp-includes/compat.php @@ -345,7 +345,6 @@ if ( ! function_exists( 'is_countable' ) ) { * @since 4.9.6 * * @param mixed $var The value to check. - * * @return bool True if `$var` is countable, false otherwise. */ function is_countable( $var ) { @@ -367,7 +366,6 @@ if ( ! function_exists( 'is_iterable' ) ) { * @since 4.9.6 * * @param mixed $var The value to check. - * * @return bool True if `$var` is iterable, false otherwise. */ function is_iterable( $var ) { diff --git a/src/wp-includes/embed.php b/src/wp-includes/embed.php index 2a171d1e36..2095f47237 100644 --- a/src/wp-includes/embed.php +++ b/src/wp-includes/embed.php @@ -57,7 +57,6 @@ function wp_embed_unregister_handler( $id, $priority = 10 ) { * @global int $content_width * * @param string $url Optional. The URL that should be embedded. Default empty. - * * @return array { * Indexed array of the embed width and height in pixels. * diff --git a/src/wp-includes/error-protection.php b/src/wp-includes/error-protection.php index fde37c7fff..c1393045be 100644 --- a/src/wp-includes/error-protection.php +++ b/src/wp-includes/error-protection.php @@ -42,7 +42,6 @@ function wp_paused_themes() { * @since 5.2.0 * * @param array $error Error details {@see error_get_last()} - * * @return string Formatted error description. */ function wp_get_extension_error_description( $error ) { diff --git a/src/wp-includes/link-template.php b/src/wp-includes/link-template.php index df3143b5aa..92c4ffbd62 100644 --- a/src/wp-includes/link-template.php +++ b/src/wp-includes/link-template.php @@ -100,7 +100,6 @@ function permalink_anchor( $mode = 'id' ) { * * @param int|WP_Post $post Optional. Post ID or post object. Default is the global `$post`. * @param bool $leavename Optional. Whether to keep post name or page name. Default false. - * * @return string|false The permalink URL or false if post does not exist. */ function get_the_permalink( $post = 0, $leavename = false ) { @@ -4437,7 +4436,6 @@ function the_privacy_policy_link( $before = '', $after = '' ) { * * @param string $before Optional. Display before privacy policy link. Default empty. * @param string $after Optional. Display after privacy policy link. Default empty. - * * @return string Markup for the link and surrounding elements. Empty string if it * doesn't exist. */ diff --git a/src/wp-includes/rest-api.php b/src/wp-includes/rest-api.php index dc55af08f3..b2e66d2093 100644 --- a/src/wp-includes/rest-api.php +++ b/src/wp-includes/rest-api.php @@ -715,10 +715,12 @@ function rest_send_allow_header( $response, $server, $request ) { /** * Recursively computes the intersection of arrays using keys for comparison. * + * @since 5.3.0 + * * @param array $array1 The array with master keys to check. * @param array $array2 An array to compare keys against. - * - * @return array An associative array containing all the entries of array1 which have keys that are present in all arguments. + * @return array An associative array containing all the entries of array1 which have keys + * that are present in all arguments. */ function _rest_array_intersect_key_recursive( $array1, $array2 ) { $array1 = array_intersect_key( $array1, $array2 ); @@ -738,7 +740,6 @@ function _rest_array_intersect_key_recursive( $array1, $array2 ) { * @param WP_REST_Response $response Current response being served. * @param WP_REST_Server $server ResponseHandler instance (usually WP_REST_Server). * @param WP_REST_Request $request The request that was used to make current response. - * * @return WP_REST_Response Response to be served, trimmed down to contain a subset of fields. */ function rest_filter_response_fields( $response, $server, $request ) { diff --git a/src/wp-includes/rest-api/class-wp-rest-request.php b/src/wp-includes/rest-api/class-wp-rest-request.php index e3ed8c424a..d9c24e0658 100644 --- a/src/wp-includes/rest-api/class-wp-rest-request.php +++ b/src/wp-includes/rest-api/class-wp-rest-request.php @@ -402,7 +402,6 @@ class WP_REST_Request implements ArrayAccess { * @since 5.3.0 * * @param string $key Parameter name. - * * @return bool True if a param exists for the given key. */ public function has_param( $key ) { diff --git a/src/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php b/src/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php index 5378e3f276..99a491de27 100644 --- a/src/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php +++ b/src/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php @@ -399,7 +399,6 @@ class WP_REST_Autosaves_Controller extends WP_REST_Revisions_Controller { * * @param WP_Post $post Post revision object. * @param WP_REST_Request $request Request object. - * * @return WP_REST_Response Response object. */ public function prepare_item_for_response( $post, $request ) { diff --git a/src/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php b/src/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php index fb6abc1985..d26026e51f 100644 --- a/src/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php +++ b/src/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php @@ -161,7 +161,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller { * @param int|bool $value The value passed to the reassign parameter. * @param WP_REST_Request $request Full details about the request. * @param string $param The parameter that is being sanitized. - * * @return int|bool|WP_Error */ public function check_reassign( $value, $request, $param ) {