From cfecc5cde5d84954b5c4812701fed396ebaabb2a Mon Sep 17 00:00:00 2001 From: Sergey Biryukov Date: Mon, 13 Nov 2023 11:11:54 +0000 Subject: [PATCH] Docs: Replace miscellaneous incorrect PHPDoc tags. * `@contrib` is not a valid tag. * `@origin` is not a valid tag. * `@ref` is not a valid tag. * `@blessed` is not a valid tag and doesn't convey any meaningful information. * `@issue` is not a valid tag. Reference: [https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#phpdoc-tags PHP Documentation Standards: PHPDoc Tags]. Follow-up to [8852], [34754], [38832], [43808]. Props jrf. See #59651. git-svn-id: https://develop.svn.wordpress.org/trunk@57108 602fd350-edb4-49c9-b593-d223f7449a82 --- src/wp-admin/includes/class-wp-filesystem-ssh2.php | 2 +- .../themes/twentynineteen/inc/template-functions.php | 5 +++-- src/wp-includes/ms-functions.php | 2 -- tests/phpunit/tests/rest-api/rest-posts-controller.php | 2 +- 4 files changed, 5 insertions(+), 6 deletions(-) diff --git a/src/wp-admin/includes/class-wp-filesystem-ssh2.php b/src/wp-admin/includes/class-wp-filesystem-ssh2.php index d68f1433d1..6979a92c2f 100644 --- a/src/wp-admin/includes/class-wp-filesystem-ssh2.php +++ b/src/wp-admin/includes/class-wp-filesystem-ssh2.php @@ -4,7 +4,7 @@ * * To use this class you must follow these steps for PHP 5.2.6+ * - * @contrib http://kevin.vanzonneveld.net/techblog/article/make_ssh_connections_with_php/ - Installation Notes + * {@link http://kevin.vanzonneveld.net/techblog/article/make_ssh_connections_with_php/ - Installation Notes} * * Compile libssh2 (Note: Only 0.14 is officaly working with PHP 5.2.6+ right now, But many users have found the latest versions work) * diff --git a/src/wp-content/themes/twentynineteen/inc/template-functions.php b/src/wp-content/themes/twentynineteen/inc/template-functions.php index 536fbd3ee4..b8bb5d5c93 100644 --- a/src/wp-content/themes/twentynineteen/inc/template-functions.php +++ b/src/wp-content/themes/twentynineteen/inc/template-functions.php @@ -100,7 +100,7 @@ add_filter( 'get_the_archive_title', 'twentynineteen_get_the_archive_title' ); /** * Adds custom 'sizes' attribute to responsive image functionality for post thumbnails. * - * @origin Twenty Nineteen 1.0 + * @since Twenty Nineteen 1.0 * * @param string[] $attr Array of attribute values for the image markup, keyed by attribute name. * See wp_get_attachment_image(). @@ -163,7 +163,8 @@ add_filter( 'wp_nav_menu', 'twentynineteen_add_ellipses_to_nav', 10, 2 ); * Adjustments to menu attributes to support WCAG 2.0 recommendations * for flyout and dropdown menus. * - * @ref https://www.w3.org/WAI/tutorials/menus/flyout/ + * @link https://www.w3.org/WAI/tutorials/menus/flyout/ + * * @param array $atts { * The HTML attributes applied to the menu item's `` element, empty strings are ignored. * diff --git a/src/wp-includes/ms-functions.php b/src/wp-includes/ms-functions.php index 09ee2a5c53..913f22543f 100644 --- a/src/wp-includes/ms-functions.php +++ b/src/wp-includes/ms-functions.php @@ -2082,8 +2082,6 @@ function redirect_this_site( $deprecated = '' ) { * * @since MU (3.0.0) * - * @blessed - * * @param array $upload An array of information about the newly-uploaded file. * @return string|array If the upload is under the size limit, $upload is returned. Otherwise returns an error message. */ diff --git a/tests/phpunit/tests/rest-api/rest-posts-controller.php b/tests/phpunit/tests/rest-api/rest-posts-controller.php index 3b58464295..f1af2f3959 100644 --- a/tests/phpunit/tests/rest-api/rest-posts-controller.php +++ b/tests/phpunit/tests/rest-api/rest-posts-controller.php @@ -256,7 +256,7 @@ class WP_Test_REST_Posts_Controller extends WP_Test_REST_Post_Type_Controller_Te /** * A valid query that returns 0 results should return an empty JSON list. * - * @issue 862 + * @link https://github.com/WP-API/WP-API/issues/862 */ public function test_get_items_empty_query() { $request = new WP_REST_Request( 'GET', '/wp/v2/posts' );