diff --git a/src/js/_enqueues/deprecated/fakejshint.js b/src/js/_enqueues/deprecated/fakejshint.js index b3290c4406064..c064d4d505c5a 100644 --- a/src/js/_enqueues/deprecated/fakejshint.js +++ b/src/js/_enqueues/deprecated/fakejshint.js @@ -6,8 +6,8 @@ * @since 4.9.3 * @deprecated 7.0.0 * @output wp-includes/js/codemirror/fakejshint.js - * @see https://core.trac.wordpress.org/ticket/42850 - * @see https://core.trac.wordpress.org/ticket/64558 + * @link https://core.trac.wordpress.org/ticket/42850 + * @link https://core.trac.wordpress.org/ticket/64558 */ /* jshint -W057, -W058 */ diff --git a/src/js/_enqueues/lib/codemirror/javascript-lint.js b/src/js/_enqueues/lib/codemirror/javascript-lint.js index 15fefe832805c..20c50d548d6f1 100644 --- a/src/js/_enqueues/lib/codemirror/javascript-lint.js +++ b/src/js/_enqueues/lib/codemirror/javascript-lint.js @@ -9,7 +9,7 @@ import CodeMirror from 'codemirror'; /** * CodeMirror Lint Error. * - * @see https://codemirror.net/5/doc/manual.html#addon_lint + * @link https://codemirror.net/5/doc/manual.html#addon_lint * * @typedef {Object} CodeMirrorLintError * @property {string} message Error message. @@ -21,8 +21,8 @@ import CodeMirror from 'codemirror'; /** * JSHint options supported by Espree. * - * @see https://jshint.com/docs/options/ - * @see https://www.npmjs.com/package/espree#options + * @link https://jshint.com/docs/options/ + * @link https://www.npmjs.com/package/espree#options * * @typedef {Object} SupportedJSHintOptions * @property {import('espree').Options['ecmaVersion']} [esversion] "This option is used to specify the ECMAScript version to which the code must adhere." diff --git a/src/wp-content/themes/twentyfifteen/inc/custom-header.php b/src/wp-content/themes/twentyfifteen/inc/custom-header.php index 699d72cec7b31..68ebb0a398f62 100644 --- a/src/wp-content/themes/twentyfifteen/inc/custom-header.php +++ b/src/wp-content/themes/twentyfifteen/inc/custom-header.php @@ -146,7 +146,7 @@ function twentyfifteen_header_style() { /* * No shorthand so the Customizer can override individual properties. - * @see https://core.trac.wordpress.org/ticket/31460 + * @link https://core.trac.wordpress.org/ticket/31460 */ background-image: url(); background-repeat: no-repeat; @@ -162,7 +162,7 @@ function twentyfifteen_header_style() { /* * No shorthand so the Customizer can override individual properties. - * @see https://core.trac.wordpress.org/ticket/31460 + * @link https://core.trac.wordpress.org/ticket/31460 */ background-image: url(); background-repeat: no-repeat; diff --git a/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-comment.php b/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-comment.php index 8012677ce8e76..329f7164ee518 100644 --- a/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-comment.php +++ b/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-comment.php @@ -22,11 +22,11 @@ class TwentyTwenty_Walker_Comment extends Walker_Comment { * @since Twenty Twenty 1.0 * * @see wp_list_comments() - * @see https://developer.wordpress.org/reference/functions/get_comment_author_url/ - * @see https://developer.wordpress.org/reference/functions/get_comment_author/ - * @see https://developer.wordpress.org/reference/functions/get_avatar/ - * @see https://developer.wordpress.org/reference/functions/get_comment_reply_link/ - * @see https://developer.wordpress.org/reference/functions/get_edit_comment_link/ + * @see get_comment_author_url() + * @see get_comment_author() + * @see get_avatar() + * @see get_comment_reply_link() + * @see get_edit_comment_link() * * @param WP_Comment $comment Comment to display. * @param int $depth Depth of the current comment. diff --git a/src/wp-includes/blocks.php b/src/wp-includes/blocks.php index 1701548d8d3fa..626e7b7f14f4a 100644 --- a/src/wp-includes/blocks.php +++ b/src/wp-includes/blocks.php @@ -2843,7 +2843,7 @@ function build_query_vars_from_query_block( $block, $page ) { * Logic should be used beforehand to determine if WP_Query should be used in the event that the array * being passed to post__in is empty. * - * @see https://core.trac.wordpress.org/ticket/28099 + * @link https://core.trac.wordpress.org/ticket/28099 */ $query['post__in'] = ! empty( $sticky ) ? $sticky : array( 0 ); $query['ignore_sticky_posts'] = 1; diff --git a/src/wp-includes/class-wp-http-requests-hooks.php b/src/wp-includes/class-wp-http-requests-hooks.php index f399acc860229..aac172892f293 100644 --- a/src/wp-includes/class-wp-http-requests-hooks.php +++ b/src/wp-includes/class-wp-http-requests-hooks.php @@ -64,10 +64,10 @@ public function dispatch( $hook, $parameters = array() ) { * * This action maps Requests internal hook to a native WordPress action. * - * @see https://github.com/WordPress/Requests/blob/master/docs/hooks.md - * * @since 4.7.0 * + * @link https://github.com/WordPress/Requests/blob/stable/docs/hooks.md + * * @param array $parameters Parameters from Requests internal hook. * @param array $request Request data in WP_Http format. * @param string $url URL to request. diff --git a/src/wp-includes/class-wp-script-modules.php b/src/wp-includes/class-wp-script-modules.php index 9c9f8a762af5e..180b42362db1a 100644 --- a/src/wp-includes/class-wp-script-modules.php +++ b/src/wp-includes/class-wp-script-modules.php @@ -1102,9 +1102,9 @@ public function print_script_module_data(): void { * is not encoded in UTF-8 then it's not safe to include those literals. They must * be escaped to avoid encoding issues. * - * @see https://www.rfc-editor.org/rfc/rfc8259.html for details on encoding requirements. - * @see https://www.php.net/manual/en/json.constants.php for details on these constants. - * @see https://html.spec.whatwg.org/#script-data-state for details on script tag parsing. + * @link https://www.rfc-editor.org/rfc/rfc8259.html for details on encoding requirements. + * @link https://www.php.net/manual/en/json.constants.php for details on these constants. + * @link https://html.spec.whatwg.org/#script-data-state for details on script tag parsing. */ $json_encode_flags = JSON_HEX_TAG | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_LINE_TERMINATORS; if ( ! is_utf8_charset() ) { diff --git a/src/wp-includes/class-wp-theme-json.php b/src/wp-includes/class-wp-theme-json.php index f665f9acd19eb..f5cdc1b43c6a1 100644 --- a/src/wp-includes/class-wp-theme-json.php +++ b/src/wp-includes/class-wp-theme-json.php @@ -1583,7 +1583,7 @@ protected static function append_to_selector( $selector, $to_append ) { * there should be no way for a comma to mean anything other than a * comma token. The exception are syntax errors, which are not handled here. * - * @see https://www.w3.org/TR/css-syntax-3/#parse-comma-separated-list-of-component-values + * @link https://www.w3.org/TR/css-syntax-3/#parse-comma-separated-list-of-component-values */ if ( strlen( $selector ) === strcspn( $selector, '/\'"(<\\' ) ) { return preg_replace( '~[ \t\n]*,[ \t\n]*~', "{$to_append}, ", trim( $selector, " \t\n" ) ) . $to_append; @@ -1632,7 +1632,7 @@ protected static function prepend_to_selector( $selector, $to_prepend ) { * there should be no way for a comma to mean anything other than a * comma token. The exception are syntax errors, which are not handled here. * - * @see https://www.w3.org/TR/css-syntax-3/#parse-comma-separated-list-of-component-values + * @link https://www.w3.org/TR/css-syntax-3/#parse-comma-separated-list-of-component-values */ if ( strlen( $selector ) === strcspn( $selector, '/\'"(<\\' ) ) { return $to_prepend . preg_replace( '~[ \t\n]*,[ \t\n]*~', ", {$to_prepend}", trim( $selector, " \t\n" ) ); @@ -1677,8 +1677,8 @@ protected static function prepend_to_selector( $selector, $to_prepend ) { * // Comments stay with the selector they follow. * array( '.a /* a, the first *\/', '.b' ) === self::split_selector_list( '.a /* a, the first *\/,.b' ); * - * @see https://www.w3.org/TR/selectors/#parse-selector - * @see https://www.w3.org/TR/css-syntax-3/ + * @link https://www.w3.org/TR/selectors/#parse-selector + * @link https://www.w3.org/TR/css-syntax-3/ * * @since 7.1.0 * @@ -1785,8 +1785,8 @@ protected static function split_selector_list( $selector ): array { * > not included in this definition, as they are converted * > to U+000A LINE FEED during preprocessing. * - * @see https://www.w3.org/TR/css-syntax/#whitespace - * @see https://www.w3.org/TR/css-syntax/#newline + * @link https://www.w3.org/TR/css-syntax/#whitespace + * @link https://www.w3.org/TR/css-syntax/#newline */ $selectors[] = trim( substr( $selector, $was_at, $next_at - $was_at ), " \t\n" ); $at = $next_at + 1; diff --git a/src/wp-includes/class-wp-url-pattern-prefixer.php b/src/wp-includes/class-wp-url-pattern-prefixer.php index a79e6e10c8cc0..3e94db53ff7b2 100644 --- a/src/wp-includes/class-wp-url-pattern-prefixer.php +++ b/src/wp-includes/class-wp-url-pattern-prefixer.php @@ -124,7 +124,7 @@ public static function get_default_contexts(): array { * Escapes a string for use in a URL pattern component. * * @since 6.8.0 - * @see https://urlpattern.spec.whatwg.org/#escape-a-pattern-string + * @link https://urlpattern.spec.whatwg.org/#escape-a-pattern-string * * @param string $str String to be escaped. * @return string String with backslashes added where required. diff --git a/src/wp-includes/class-wpdb.php b/src/wp-includes/class-wpdb.php index f961813c3f386..9537cdc57cf2c 100644 --- a/src/wp-includes/class-wpdb.php +++ b/src/wp-includes/class-wpdb.php @@ -1992,7 +1992,7 @@ public function db_connect( $allow_bail = true ) { /* * If using the `mysqlnd` library, the IPv6 address needs to be enclosed * in square brackets, whereas it doesn't while using the `libmysqlclient` library. - * @see https://bugs.php.net/bug.php?id=67563 + * @link https://bugs.php.net/bug.php?id=67563 */ if ( $is_ipv6 && extension_loaded( 'mysqlnd' ) ) { $host = "[$host]"; diff --git a/src/wp-includes/compat-utf8.php b/src/wp-includes/compat-utf8.php index 5fa8cde158789..326786fe608f2 100644 --- a/src/wp-includes/compat-utf8.php +++ b/src/wp-includes/compat-utf8.php @@ -120,7 +120,7 @@ function _wp_scan_utf8( string $bytes, int &$at, int &$invalid_length, ?int $max * │ U+100000..U+10FFFF │ F4 │ 80..8F │ 80..BF │ 80..BF │ * ╰─────────────────────┴────────────┴──────────────┴─────────────┴──────────────╯ * - * @see https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-3/#G27506 + * @link https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-3/#G27506 */ // Valid two-byte code points. @@ -197,7 +197,7 @@ function _wp_scan_utf8( string $bytes, int &$at, int &$invalid_length, ?int $max * > Furthermore, this practice can be defined consistently for better * > interoperability between different implementations of conversion. * - * @see https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-5/#G40630 + * @link https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-5/#G40630 */ invalid_utf8: $at = $i; diff --git a/src/wp-includes/compat.php b/src/wp-includes/compat.php index bd0c09881a4e4..0aac0481c5d23 100644 --- a/src/wp-includes/compat.php +++ b/src/wp-includes/compat.php @@ -18,7 +18,7 @@ * * @since 0.71 * - * @see https://php.net/manual/en/function.gettext.php + * @link https://php.net/manual/en/function.gettext.php * * @param string $message The message being translated. * @return string @@ -459,7 +459,7 @@ function utf8_decode( $utf8_text ): string { * * An array is considered a list if its keys consist of consecutive numbers from 0 to count($array)-1. * - * @see https://github.com/symfony/polyfill-php81/tree/main + * @link https://github.com/symfony/polyfill-php81/tree/main * * @since 6.5.0 * diff --git a/src/wp-includes/customize/class-wp-customize-custom-css-setting.php b/src/wp-includes/customize/class-wp-customize-custom-css-setting.php index 58897a7e72742..ed825618b2dc1 100644 --- a/src/wp-includes/customize/class-wp-customize-custom-css-setting.php +++ b/src/wp-includes/customize/class-wp-customize-custom-css-setting.php @@ -201,7 +201,7 @@ public function validate( $value ) { * that would have broken out of the containing STYLE element, thus * corrupting the page and potentially introducing security issues. * - * @see https://html.spec.whatwg.org/multipage/parsing.html#rawtext-end-tag-name-state + * @link https://html.spec.whatwg.org/multipage/parsing.html#rawtext-end-tag-name-state */ $possible_style_close_tag = 0 === substr_compare( $css, diff --git a/src/wp-includes/deprecated.php b/src/wp-includes/deprecated.php index df621af9267c4..63aa0d3abe8bc 100644 --- a/src/wp-includes/deprecated.php +++ b/src/wp-includes/deprecated.php @@ -6384,12 +6384,12 @@ function wp_get_global_styles_custom_css() { * that can use dynamic data (modify the stylesheet depending on some option, * settings depending on user permissions, etc.). * See some of the existing hooks to modify theme.json behavior: - * @see https://make.wordpress.org/core/2022/10/10/filters-for-theme-json-data/ + * @link https://make.wordpress.org/core/2022/10/10/filters-for-theme-json-data/ * * A different alternative considered was to invalidate the cache upon certain * events such as options add/update/delete, user meta, etc. * It was judged not enough, hence this approach. - * @see https://github.com/WordPress/gutenberg/pull/45372 + * @link https://github.com/WordPress/gutenberg/pull/45372 */ $cache_key = 'wp_get_global_styles_custom_css'; $cache_group = 'theme_json'; @@ -6517,9 +6517,9 @@ function wp_add_editor_classic_theme_styles( $editor_settings ) { * @deprecated 6.9.0 Use wp_enqueue_img_auto_sizes_contain_css_fix() instead. * @see wp_enqueue_img_auto_sizes_contain_css_fix() * - * @see https://html.spec.whatwg.org/multipage/rendering.html#img-contain-size - * @see https://core.trac.wordpress.org/ticket/62413 - * @see https://core.trac.wordpress.org/ticket/62731 + * @link https://html.spec.whatwg.org/multipage/rendering.html#img-contain-size + * @link https://core.trac.wordpress.org/ticket/62413 + * @link https://core.trac.wordpress.org/ticket/62731 */ function wp_print_auto_sizes_contain_css_fix() { _deprecated_function( __FUNCTION__, '6.9.0', 'wp_enqueue_img_auto_sizes_contain_css_fix' ); diff --git a/src/wp-includes/formatting.php b/src/wp-includes/formatting.php index 58d39a98a7a3c..d261721d70ccf 100644 --- a/src/wp-includes/formatting.php +++ b/src/wp-includes/formatting.php @@ -2054,9 +2054,9 @@ function sanitize_file_name( $filename ) { * The “Zs” in the pattern selects characters in the `Space_Separator` * category, which is what Unicode considers space characters. * - * @see https://www.unicode.org/reports/tr44/#General_Category_Values - * @see https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-6/#G17548 - * @see https://www.php.net/manual/en/regexp.reference.unicode.php + * @link https://www.unicode.org/reports/tr44/#General_Category_Values + * @link https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-6/#G17548 + * @link https://www.php.net/manual/en/regexp.reference.unicode.php */ $filename = preg_replace( '#\p{Zs}#siu', ' ', $filename ); } @@ -2655,8 +2655,8 @@ function force_balance_tags( $text ) { * To get the pattern as a string without the comments paste into a PHP * REPL like `php -a`. * - * @see https://html.spec.whatwg.org/#elements-2 - * @see https://html.spec.whatwg.org/multipage/custom-elements.html#valid-custom-element-name + * @link https://html.spec.whatwg.org/#elements-2 + * @link https://html.spec.whatwg.org/multipage/custom-elements.html#valid-custom-element-name * * @example * ~# php -a diff --git a/src/wp-includes/functions.php b/src/wp-includes/functions.php index b56f4986fa9a2..3b8f5bd555a4c 100644 --- a/src/wp-includes/functions.php +++ b/src/wp-includes/functions.php @@ -1077,7 +1077,7 @@ function build_query( $data ) { * @since 3.2.0 * @access private * - * @see https://www.php.net/manual/en/function.http-build-query.php + * @link https://www.php.net/manual/en/function.http-build-query.php * * @param array|object $data An array or object of data. Converted to array. * @param string $prefix Optional. Numeric index. If set, start parameter numbering with it. @@ -2330,8 +2330,8 @@ function wp_is_writable( $path ) { * * @since 2.8.0 * - * @see https://bugs.php.net/bug.php?id=27609 - * @see https://bugs.php.net/bug.php?id=30931 + * @link https://bugs.php.net/bug.php?id=27609 + * @link https://bugs.php.net/bug.php?id=30931 * * @param string $path Windows path to check for write-ability. * @return bool Whether the path is writable. @@ -3265,8 +3265,8 @@ function wp_check_filetype_and_ext( $file, $filename, $mimes = null ) { * finfo_file() can return duplicate mime type for Google docs, * this conditional reduces it to a single instance. * - * @see https://bugs.php.net/bug.php?id=77784 - * @see https://core.trac.wordpress.org/ticket/57898 + * @link https://bugs.php.net/bug.php?id=77784 + * @link https://core.trac.wordpress.org/ticket/57898 */ if ( 2 === substr_count( $real_mime, $google_docs_type ) ) { $real_mime = $google_docs_type; @@ -7047,7 +7047,7 @@ function wp_timezone_choice( $selected_zone, $locale = null ) { * @since 2.8.0 * @access private * - * @see https://core.trac.wordpress.org/ticket/8497 + * @link https://core.trac.wordpress.org/ticket/8497 * * @param string $str Header comment to clean up. * @return string Cleaned header comment. @@ -7257,8 +7257,8 @@ function __return_empty_string() { // phpcs:ignore WordPress.NamingConventions.V * * @since 3.0.0 * - * @see https://blogs.msdn.com/ie/archive/2008/07/02/ie8-security-part-v-comprehensive-protection.aspx - * @see https://src.chromium.org/viewvc/chrome?view=rev&revision=6985 + * @link https://learn.microsoft.com/en-us/archive/blogs/ie/ie8-security-part-v-comprehensive-protection + * @link https://fetch.spec.whatwg.org/#x-content-type-options-header */ function send_nosniff_header() { header( 'X-Content-Type-Options: nosniff' ); @@ -7375,8 +7375,8 @@ function wp_find_hierarchy_loop_tortoise_hare( $callback, $start, $override = ar * * @since 3.1.3 * - * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Frame-Options - * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy/frame-ancestors + * @link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Frame-Options + * @link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy/frame-ancestors */ function send_frame_options_header() { if ( ! headers_sent() ) { @@ -7454,7 +7454,7 @@ function wp_allowed_protocols() { * * @since 3.4.0 * - * @see https://core.trac.wordpress.org/ticket/19589 + * @link https://core.trac.wordpress.org/ticket/19589 * * @param string $ignore_class Optional. A class to ignore all function calls within - useful * when you want to just give info about the callee. Default null. @@ -7827,7 +7827,7 @@ function is_utf8_charset( $blog_charset = null ) { * @since 3.6.0 * @access private * - * @see https://core.trac.wordpress.org/ticket/23688 + * @link https://core.trac.wordpress.org/ticket/23688 * * @param string $charset A charset name, e.g. "UTF-8", "Windows-1252", "SJIS". * @return string The canonical form of the charset. diff --git a/src/wp-includes/global-styles-and-settings.php b/src/wp-includes/global-styles-and-settings.php index 8c9affa79a575..efa1c08d0758d 100644 --- a/src/wp-includes/global-styles-and-settings.php +++ b/src/wp-includes/global-styles-and-settings.php @@ -144,12 +144,12 @@ function wp_get_global_stylesheet( $types = array() ) { * that can use dynamic data (modify the stylesheet depending on some option, * settings depending on user permissions, etc.). * See some of the existing hooks to modify theme.json behavior: - * @see https://make.wordpress.org/core/2022/10/10/filters-for-theme-json-data/ + * @link https://make.wordpress.org/core/2022/10/10/filters-for-theme-json-data/ * * A different alternative considered was to invalidate the cache upon certain * events such as options add/update/delete, user meta, etc. * It was judged not enough, hence this approach. - * @see https://github.com/WordPress/gutenberg/pull/45372 + * @link https://github.com/WordPress/gutenberg/pull/45372 */ $cache_group = 'theme_json'; $cache_key = 'wp_get_global_stylesheet'; diff --git a/src/wp-includes/kses.php b/src/wp-includes/kses.php index aba6e0d2a559a..cbe2f4d04c3a7 100644 --- a/src/wp-includes/kses.php +++ b/src/wp-includes/kses.php @@ -2489,7 +2489,7 @@ function wp_kses_split2( $content, $allowed_html, $allowed_protocols ) { * * Preserve these comments and do not treat them like tags. * - * @see https://html.spec.whatwg.org/#bogus-comment-state + * @link https://html.spec.whatwg.org/#bogus-comment-state */ if ( 1 === preg_match( '~^(?:]*>|]*>)$~', $content ) ) { /** @@ -3389,7 +3389,7 @@ function wp_kses_normalize_entities3( $matches ) { * * @since 2.7.0 * - * @see https://www.w3.org/TR/xml/#charsets + * @link https://www.w3.org/TR/xml/#charsets * * @param int $i Unicode codepoint. * @return bool Whether or not the codepoint is a valid Unicode codepoint. diff --git a/src/wp-includes/media.php b/src/wp-includes/media.php index 2ffa92f2edba0..3bb70456116d6 100644 --- a/src/wp-includes/media.php +++ b/src/wp-includes/media.php @@ -2189,9 +2189,9 @@ function wp_sizes_attribute_includes_valid_auto( string $sizes_attr ): bool { * * @since 6.9.0 * - * @see https://html.spec.whatwg.org/multipage/rendering.html#img-contain-size - * @see https://core.trac.wordpress.org/ticket/62413 - * @see https://core.trac.wordpress.org/ticket/62731 + * @link https://html.spec.whatwg.org/multipage/rendering.html#img-contain-size + * @link https://core.trac.wordpress.org/ticket/62413 + * @link https://core.trac.wordpress.org/ticket/62731 */ function wp_enqueue_img_auto_sizes_contain_css_fix(): void { // Back-compat for plugins that disable functionality by unhooking this action. diff --git a/src/wp-includes/nav-menu-template.php b/src/wp-includes/nav-menu-template.php index bad702e35d081..c11f00855cf0d 100644 --- a/src/wp-includes/nav-menu-template.php +++ b/src/wp-includes/nav-menu-template.php @@ -651,7 +651,7 @@ function _nav_menu_item_id_use_once( $id, $item ) { * WordPress 3.0.0 so this needs to allow for cases in which the filter is * called without them. * - * @see https://core.trac.wordpress.org/ticket/56926 + * @link https://core.trac.wordpress.org/ticket/56926 * * @since 6.2.0 * diff --git a/src/wp-includes/pluggable.php b/src/wp-includes/pluggable.php index d13769cf84afe..0aaeabbb3b9c0 100644 --- a/src/wp-includes/pluggable.php +++ b/src/wp-includes/pluggable.php @@ -2392,7 +2392,7 @@ function wp_new_user_notification( $user_id, $deprecated = null, $notify = '' ) * end in a period. To avoid the ambiguity, ensure that the login is not the last query * arg in the URL. If moving it to the end, a trailing period will need to be escaped. * - * @see https://core.trac.wordpress.org/tickets/42957 + * @link https://core.trac.wordpress.org/ticket/42957 */ $message .= network_site_url( 'wp-login.php?login=' . rawurlencode( $user->user_login ) . "&key=$key&action=rp", 'login' ) . "\r\n"; diff --git a/src/wp-includes/script-loader.php b/src/wp-includes/script-loader.php index cd1d53a5fb93f..dfaaf73ede55a 100644 --- a/src/wp-includes/script-loader.php +++ b/src/wp-includes/script-loader.php @@ -178,7 +178,7 @@ function wp_default_packages_vendor( $scripts ) { * These scripts enable hot module replacement (HMR) for block development * when using `wp-scripts start --hot`. * - * @see https://github.com/WordPress/gutenberg/tree/trunk/packages/scripts#start + * @link https://github.com/WordPress/gutenberg/tree/trunk/packages/scripts#start * * @since 6.0.0 * @@ -3051,7 +3051,7 @@ function wp_prefetch_admin_assets(): void { /** * Prefetches the page's rel=prefetch links with fetch() in browsers that do not support rel=prefetch. * - * @see https://caniuse.com/link-rel-prefetch + * @link https://caniuse.com/link-rel-prefetch */ () => { if ( document.createElement( 'link' ).relList?.supports?.( 'prefetch' ) ) { @@ -4657,8 +4657,8 @@ public function replace( string $text ): void { * * @since 6.9.0 * - * @see https://html.spec.whatwg.org/#concept-domstringmap-pairs * @see \wp_html_custom_data_attribute_name() + * @link https://html.spec.whatwg.org/#concept-domstringmap-pairs * * @param string $html_attribute_name Raw attribute name as found in the source HTML. * @return string|null Transformed `dataset` name, if interpretable as a custom data attribute, else `null`. @@ -4684,7 +4684,7 @@ function wp_js_dataset_name( string $html_attribute_name ): ?string { * > U+002D HYPHEN-MINUS character (-) and replace the character that * > followed it by the same character converted to ASCII uppercase. * - * @see https://html.spec.whatwg.org/#concept-domstringmap-pairs + * @link https://html.spec.whatwg.org/#concept-domstringmap-pairs */ $custom_name = ''; $at = 5; @@ -4735,8 +4735,8 @@ function wp_js_dataset_name( string $html_attribute_name ): ?string { * * @since 6.9.0 * - * @see https://html.spec.whatwg.org/#concept-domstringmap-pairs * @see \wp_js_dataset_name() + * @link https://html.spec.whatwg.org/#concept-domstringmap-pairs * * @param string $js_dataset_name Name of JS `dataset` property to transform. * @return string|null Corresponding name of an HTML custom data attribute for the given dataset name, diff --git a/src/wp-includes/speculative-loading.php b/src/wp-includes/speculative-loading.php index dd33cc5395ab5..bb20f805a738a 100644 --- a/src/wp-includes/speculative-loading.php +++ b/src/wp-includes/speculative-loading.php @@ -51,7 +51,7 @@ function wp_get_speculation_rules_configuration(): ?array { * indicating that speculative loading is entirely disabled. * * @since 6.8.0 - * @see https://developer.chrome.com/docs/web-platform/prerender-pages + * @link https://developer.chrome.com/docs/web-platform/prerender-pages * * @param array|null $config Associative array with 'mode' and 'eagerness' keys, or `null`. The * default value for both of the keys is 'auto'. Other possible values diff --git a/src/wp-includes/style-engine.php b/src/wp-includes/style-engine.php index b5c7c968631b4..835f1c3f1b723 100644 --- a/src/wp-includes/style-engine.php +++ b/src/wp-includes/style-engine.php @@ -32,8 +32,8 @@ * * @since 6.1.0 * - * @see https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/#styles - * @see https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/ + * @link https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/#styles + * @link https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/ * * @param array $block_styles The style object. * @param array $options { diff --git a/src/wp-includes/theme-previews.php b/src/wp-includes/theme-previews.php index 287559c984360..8b0695cd054f3 100644 --- a/src/wp-includes/theme-previews.php +++ b/src/wp-includes/theme-previews.php @@ -61,7 +61,7 @@ function wp_attach_theme_preview_middleware() { * Sets the JavaScript global WP_BLOCK_THEME_ACTIVATE_NONCE containing the nonce * required to activate a theme. For use within the site editor. * - * @see https://github.com/WordPress/gutenberg/pull/41836 + * @link https://github.com/WordPress/gutenberg/pull/41836 * * @since 6.3.0 * @access private diff --git a/src/wp-includes/user.php b/src/wp-includes/user.php index 30c418ee264cc..e1030ee025278 100644 --- a/src/wp-includes/user.php +++ b/src/wp-includes/user.php @@ -3421,7 +3421,7 @@ function retrieve_password( $user_login = '' ) { * end in a period. To avoid the ambiguity, ensure that the login is not the last query * arg in the URL. If moving it to the end, a trailing period will need to be escaped. * - * @see https://core.trac.wordpress.org/tickets/42957 + * @link https://core.trac.wordpress.org/ticket/42957 */ $message .= network_site_url( 'wp-login.php?login=' . rawurlencode( $user_login ) . "&key=$key&action=rp", 'login' ) . '&wp_lang=' . $locale . "\r\n\r\n"; diff --git a/src/wp-includes/utf8.php b/src/wp-includes/utf8.php index 6be22a61ff83a..666d1d4260557 100644 --- a/src/wp-includes/utf8.php +++ b/src/wp-includes/utf8.php @@ -29,7 +29,7 @@ * byte sequence required by UTF-8, and that no sequence encodes a UTF-16 surrogate * code point or any character above the representable range. * - * @see https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-3/#G32860 + * @link https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-3/#G32860 * * @since 6.9.0 * @@ -101,7 +101,7 @@ function wp_is_valid_utf8( string $string ): bool { * * @since 6.9.0 * - * @see https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-5/#G40630 + * @link https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-5/#G40630 * * @param string $text String which is assumed to be UTF-8 but may contain invalid sequences of bytes. * @return string Input text with invalid sequences of bytes replaced with the Unicode replacement character. @@ -146,9 +146,9 @@ function wp_scrub_utf8( $text ) { * - U+FFFE–U+FFFF * - U+1FFFE, U+1FFFF, U+2FFFE, U+2FFFF, …, U+10FFFE, U+10FFFF * - * @see https://www.unicode.org/versions/Unicode17.0.0/core-spec/chapter-23/#G12612 - * @see https://www.w3.org/TR/xml/#charsets - * @see https://html.spec.whatwg.org/#attributes-2 + * @link https://www.unicode.org/versions/Unicode17.0.0/core-spec/chapter-23/#G12612 + * @link https://www.w3.org/TR/xml/#charsets + * @link https://html.spec.whatwg.org/#attributes-2 * * @since 6.9.0 * diff --git a/src/wp-load.php b/src/wp-load.php index 40c141f74034b..684797f8c4de3 100644 --- a/src/wp-load.php +++ b/src/wp-load.php @@ -31,7 +31,7 @@ * Initialize error reporting to a known set of levels. * * This will be adapted in wp_debug_mode() located in wp-includes/load.php based on WP_DEBUG. - * @see https://www.php.net/manual/en/errorfunc.constants.php List of known error levels. + * @link https://www.php.net/manual/en/errorfunc.constants.php List of known error levels. */ error_reporting( E_CORE_ERROR | E_CORE_WARNING | E_COMPILE_ERROR | E_ERROR | E_WARNING | E_PARSE | E_USER_ERROR | E_USER_WARNING | E_RECOVERABLE_ERROR ); } diff --git a/tests/phpunit/tests/actions.php b/tests/phpunit/tests/actions.php index 4e25cca0e2e99..f3144e4f954e9 100644 --- a/tests/phpunit/tests/actions.php +++ b/tests/phpunit/tests/actions.php @@ -187,7 +187,7 @@ public function test_action_args_2() { * Test that multiple callbacks receive the correct number of args even when the number * is less than, or greater than previous hooks. * - * @see https://core.trac.wordpress.org/ticket/17817#comment:72 + * @link https://core.trac.wordpress.org/ticket/17817#comment:72 * @ticket 17817 * * @covers ::do_action diff --git a/tests/phpunit/tests/auth.php b/tests/phpunit/tests/auth.php index a290d11e118e6..e832303869e66 100644 --- a/tests/phpunit/tests/auth.php +++ b/tests/phpunit/tests/auth.php @@ -679,7 +679,7 @@ public function test_setting_password_beyond_bcrypt_length_limit_is_rejected() { } /** - * @see https://core.trac.wordpress.org/changeset/30466 + * @link https://core.trac.wordpress.org/changeset/30466 */ public function test_invalid_password_at_phpass_length_limit_is_rejected() { $limit = str_repeat( 'a', self::$phpass_length_limit ); diff --git a/tests/phpunit/tests/blocks/serialize.php b/tests/phpunit/tests/blocks/serialize.php index 5d119e655babc..4ace7bf8cba47 100644 --- a/tests/phpunit/tests/blocks/serialize.php +++ b/tests/phpunit/tests/blocks/serialize.php @@ -88,8 +88,8 @@ public static function data_serialize_identity_from_parsed(): array { * Ensure that the previous escape form can be parsed compatibly and serialized back to * the new form. * - * @see https://github.com/WordPress/wordpress-develop/pull/9558 - * @see https://github.com/WordPress/gutenberg/pull/71291 + * @link https://github.com/WordPress/wordpress-develop/pull/9558 + * @link https://github.com/WordPress/gutenberg/pull/71291 * * @ticket 63917 * diff --git a/tests/phpunit/tests/formatting/balanceTags.php b/tests/phpunit/tests/formatting/balanceTags.php index 47e505c362924..a25b7e5511e4d 100644 --- a/tests/phpunit/tests/formatting/balanceTags.php +++ b/tests/phpunit/tests/formatting/balanceTags.php @@ -75,7 +75,7 @@ public function test_ignores_unsupported_custom_tag_names( $tag ) { /** * These are valid custom elements but we don't support them yet. * - * @see https://html.spec.whatwg.org/multipage/custom-elements.html#valid-custom-element-name + * @link https://html.spec.whatwg.org/multipage/custom-elements.html#valid-custom-element-name */ public function data_unsupported_valid_tag_names() { return array( @@ -143,7 +143,7 @@ public function test_detects_supported_invalid_tag_names( $tag ) { /** * These are invalid custom elements but we support them right now in order to keep the parser simpler. * - * @see https://w3c.github.io/webcomponents/spec/custom/#valid-custom-element-name + * @link https://w3c.github.io/webcomponents/spec/custom/#valid-custom-element-name */ public function data_supported_invalid_tag_names() { return array( diff --git a/tests/phpunit/tests/pomo/pluralForms.php b/tests/phpunit/tests/pomo/pluralForms.php index f3b5d82a01b4b..aace128123e2a 100644 --- a/tests/phpunit/tests/pomo/pluralForms.php +++ b/tests/phpunit/tests/pomo/pluralForms.php @@ -65,7 +65,7 @@ public function test_regression( int $nplurals, string $expression ): void { /** * Distinct plural expressions from the GlotPress locales file, keyed by one locale that uses each. * - * @see https://github.com/GlotPress/GlotPress/blob/1bf58a783e1888849faf45b53dbc84bc169b3246/locales/locales.php + * @link https://github.com/GlotPress/GlotPress/blob/1bf58a783e1888849faf45b53dbc84bc169b3246/locales/locales.php * * @return array */ diff --git a/tests/phpunit/tests/rest-api/wpRestMenuItemsController.php b/tests/phpunit/tests/rest-api/wpRestMenuItemsController.php index 85d5618ab964c..7ddc12d0492a9 100644 --- a/tests/phpunit/tests/rest-api/wpRestMenuItemsController.php +++ b/tests/phpunit/tests/rest-api/wpRestMenuItemsController.php @@ -310,7 +310,7 @@ public function test_get_item_term_posts() { * Test that title.raw contains the verbatim title and that title.rendered * has been passed through the_title which escapes & characters. * - * @see https://github.com/WordPress/gutenberg/pull/24673 + * @link https://github.com/WordPress/gutenberg/pull/24673 * * @ticket 40878 * @covers ::get_item