Docs: Replace incorrect @see usage with @link

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 */

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."

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(<?php header_image(); ?>);
 			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(<?php header_image(); ?>);
 				background-repeat: no-repeat;

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.

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;

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.

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() ) {

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;

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.

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]";

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;

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
 	 *

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,

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' );

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

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.

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';

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( '~^(?:</[^a-zA-Z][^>]*>|<![a-z][^>]*>)$~', $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.

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.

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
  *

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";