Docs: Replace incorrect @see usage with @link

src/wp-includes/class-wp-http-requests-hooks.php

@@ -64,7 +64,7 @@ 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
+		 * @link https://github.com/WordPress/Requests/blob/master/docs/hooks.md
 		 *
 		 * @since 4.7.0
 		 *

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/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
@@ -309,7 +309,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

@@ -6328,12 +6328,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';
@@ -6462,9 +6462,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/global-styles-and-settings.php

@@ -57,7 +57,7 @@ function wp_get_global_settings( $path = array(), $context = array() ) {
 	 * 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_settings_' . $origin;

src/wp-includes/html-api/class-wp-html-active-formatting-elements.php

@@ -30,7 +30,7 @@
  *
  * @access private
  *
- * @see https://html.spec.whatwg.org/#list-of-active-formatting-elements
+ * @link https://html.spec.whatwg.org/#list-of-active-formatting-elements
  * @see WP_HTML_Processor
  */
 class WP_HTML_Active_Formatting_Elements {
@@ -94,7 +94,7 @@ public function current_node() {
 	 * > formatting from "leaking" into applet, object, marquee, template,
 	 * > td, th, and caption elements.
 	 *
-	 * @see https://html.spec.whatwg.org/#concept-parser-marker
+	 * @link https://html.spec.whatwg.org/#concept-parser-marker
 	 *
 	 * @since 6.7.0
 	 */
@@ -107,7 +107,7 @@ public function insert_marker(): void {
 	 *
 	 * @since 6.4.0
 	 *
-	 * @see https://html.spec.whatwg.org/#push-onto-the-list-of-active-formatting-elements
+	 * @link https://html.spec.whatwg.org/#push-onto-the-list-of-active-formatting-elements
 	 *
 	 * @param WP_HTML_Token $token Push this node onto the stack.
 	 */
@@ -214,7 +214,7 @@ public function walk_up() {
 	 * >    The list has been cleared up to the last marker.
 	 * > 4. Go to step 1.
 	 *
-	 * @see https://html.spec.whatwg.org/multipage/parsing.html#clear-the-list-of-active-formatting-elements-up-to-the-last-marker
+	 * @link https://html.spec.whatwg.org/multipage/parsing.html#clear-the-list-of-active-formatting-elements-up-to-the-last-marker
 	 *
 	 * @since 6.7.0
 	 */

src/wp-includes/html-api/class-wp-html-decoder.php

@@ -295,7 +295,7 @@ public static function read_character_reference( $context, $text, $at = 0, &$mat
 			 * This comment is here to note and explain why there's no check to
 			 * remove these characters or replace them.
 			 *
-			 * @see https://infra.spec.whatwg.org/#noncharacter
+			 * @link https://infra.spec.whatwg.org/#noncharacter
 			 */
 
 			/*
@@ -418,7 +418,7 @@ public static function read_character_reference( $context, $text, $at = 0, &$mat
 	 *
 	 * @since 6.6.0
 	 *
-	 * @see https://www.rfc-editor.org/rfc/rfc3629 For the UTF-8 standard.
+	 * @link https://www.rfc-editor.org/rfc/rfc3629 For the UTF-8 standard.
 	 *
 	 * @param int $code_point Which code point to convert.
 	 * @return string Converted code point, or `�` if invalid.

src/wp-includes/html-api/class-wp-html-doctype-info.php

@@ -33,20 +33,20 @@
  * > document ensures that the browser makes a best-effort attempt at following the
  * > relevant specifications.
  *
- * @see https://html.spec.whatwg.org/#the-doctype
+ * @link https://html.spec.whatwg.org/#the-doctype
  *
  * DOCTYPE declarations comprise four properties: a name, public identifier, system identifier,
  * and an indication of which document compatibility mode they would imply if an HTML parser
  * hadn't already determined it from other information.
  *
- * @see https://html.spec.whatwg.org/#the-initial-insertion-mode
+ * @link https://html.spec.whatwg.org/#the-initial-insertion-mode
  *
  * Historically, the DOCTYPE declaration was used in SGML documents to instruct a parser how
  * to interpret the various tags and entities within a document. Its role in HTML diverged
  * from how it was used in SGML and no meaning should be back-read into HTML based on how it
  * is used in SGML, XML, or XHTML documents.
  *
- * @see https://www.iso.org/standard/16387.html
+ * @link https://www.iso.org/standard/16387.html
  *
  * @since 6.7.0
  *
@@ -65,7 +65,7 @@ class WP_HTML_Doctype_Info {
 	 *     <!DOCTYPE html>
 	 *               ╰──┴── name is "html".
 	 *
-	 * @see https://html.spec.whatwg.org/#tokenization
+	 * @link https://html.spec.whatwg.org/#tokenization
 	 *
 	 * @since 6.7.0
 	 *
@@ -89,7 +89,7 @@ class WP_HTML_Doctype_Info {
 	 *               │  │         ╰─── public identifier ─────╯
 	 *               ╰──┴── name is "html".
 	 *
-	 * @see https://html.spec.whatwg.org/#tokenization
+	 * @link https://html.spec.whatwg.org/#tokenization
 	 *
 	 * @since 6.7.0
 	 *
@@ -119,7 +119,7 @@ class WP_HTML_Doctype_Info {
 	 *               │  │         ╰─── public identifier ─────╯   ╰──── system identifier ────╯
 	 *               ╰──┴── name is "html".
 	 *
-	 * @see https://html.spec.whatwg.org/#tokenization
+	 * @link https://html.spec.whatwg.org/#tokenization
 	 *
 	 * @since 6.7.0
 	 *
@@ -144,7 +144,7 @@ class WP_HTML_Doctype_Info {
 	 * before the HTML element has been opened and before finding any other
 	 * DOCTYPE declaration tokens.
 	 *
-	 * @see https://html.spec.whatwg.org/#the-initial-insertion-mode
+	 * @link https://html.spec.whatwg.org/#the-initial-insertion-mode
 	 *
 	 * @since 6.7.0
 	 *
@@ -166,7 +166,7 @@ class WP_HTML_Doctype_Info {
 	 * > and system identifier must be marked as missing (which is a distinct state from the
 	 * > empty string), and the force-quirks flag must be set to off (its other state is on).
 	 *
-	 * @see https://html.spec.whatwg.org/multipage/parsing.html#tokenization
+	 * @link https://html.spec.whatwg.org/multipage/parsing.html#tokenization
 	 *
 	 * @since 6.7.0
 	 *
@@ -422,7 +422,7 @@ public static function from_doctype_token( string $doctype_html ): ?self {
 		 * This parser combines the rules for parsing DOCTYPE tokens found in the HTML
 		 * specification for the DOCTYPE related tokenizer states.
 		 *
-		 * @see https://html.spec.whatwg.org/#doctype-state
+		 * @link https://html.spec.whatwg.org/#doctype-state
 		 */
 
 		/*
@@ -447,8 +447,8 @@ public static function from_doctype_token( string $doctype_html ): ?self {
 		/*
 		 * Perform newline normalization and ensure the $end value is correct after normalization.
 		 *
-		 * @see https://html.spec.whatwg.org/#preprocessing-the-input-stream
-		 * @see https://infra.spec.whatwg.org/#normalize-newlines
+		 * @link https://html.spec.whatwg.org/#preprocessing-the-input-stream
+		 * @link https://infra.spec.whatwg.org/#normalize-newlines
 		 */
 		$doctype_html = str_replace( "\r\n", "\n", $doctype_html );
 		$doctype_html = str_replace( "\r", "\n", $doctype_html );
@@ -477,7 +477,7 @@ public static function from_doctype_token( string $doctype_html ): ?self {
 		 * Parsing effectively begins in "Before DOCTYPE name state". Ignore whitespace and
 		 * proceed to the next state.
 		 *
-		 * @see https://html.spec.whatwg.org/#before-doctype-name-state
+		 * @link https://html.spec.whatwg.org/#before-doctype-name-state
 		 */
 		$at += strspn( $doctype_html, " \t\n\f\r", $at );
 
@@ -500,7 +500,7 @@ public static function from_doctype_token( string $doctype_html ): ?self {
 		 * Find a case-insensitive match for "PUBLIC" or "SYSTEM" at this point.
 		 * Otherwise, set force-quirks and enter bogus DOCTYPE state (skip the rest of the doctype).
 		 *
-		 * @see https://html.spec.whatwg.org/#after-doctype-name-state
+		 * @link https://html.spec.whatwg.org/#after-doctype-name-state
 		 */
 		if ( $at + 6 >= $end ) {
 			return new self( $doctype_name, $doctype_public_id, $doctype_system_id, true );
@@ -547,8 +547,8 @@ public static function from_doctype_token( string $doctype_html ): ?self {
 		 * "DOCTYPE public identifier (single-quoted) state" by finding one of the valid quotes.
 		 * Anything else forces quirks mode and ignores the rest of the contents.
 		 *
-		 * @see https://html.spec.whatwg.org/#doctype-public-identifier-(double-quoted)-state
-		 * @see https://html.spec.whatwg.org/#doctype-public-identifier-(single-quoted)-state
+		 * @link https://html.spec.whatwg.org/#doctype-public-identifier-(double-quoted)-state
+		 * @link https://html.spec.whatwg.org/#doctype-public-identifier-(single-quoted)-state
 		 */
 		$closer_quote = $doctype_html[ $at ];
 
@@ -577,7 +577,7 @@ public static function from_doctype_token( string $doctype_html ): ?self {
 		 *
 		 * Advance through whitespace between public and system identifiers.
 		 *
-		 * @see https://html.spec.whatwg.org/#between-doctype-public-and-system-identifiers-state
+		 * @link https://html.spec.whatwg.org/#between-doctype-public-and-system-identifiers-state
 		 */
 		$at += strspn( $doctype_html, " \t\n\f\r", $at, $end - $at );
 		if ( $at >= $end ) {
@@ -590,8 +590,8 @@ public static function from_doctype_token( string $doctype_html ): ?self {
 		 * "DOCTYPE system identifier (single-quoted) state" by finding one of the valid quotes.
 		 * Anything else forces quirks mode and ignores the rest of the contents.
 		 *
-		 * @see https://html.spec.whatwg.org/#doctype-system-identifier-(double-quoted)-state
-		 * @see https://html.spec.whatwg.org/#doctype-system-identifier-(single-quoted)-state
+		 * @link https://html.spec.whatwg.org/#doctype-system-identifier-(double-quoted)-state
+		 * @link https://html.spec.whatwg.org/#doctype-system-identifier-(single-quoted)-state
 		 */
 		$closer_quote = $doctype_html[ $at ];
 

src/wp-includes/html-api/class-wp-html-open-elements.php

@@ -439,7 +439,7 @@ public function has_element_in_button_scope( string $tag_name ): bool {
 	 * @since 6.4.0
 	 * @since 6.7.0 Full implementation.
 	 *
-	 * @see https://html.spec.whatwg.org/#has-an-element-in-table-scope
+	 * @link https://html.spec.whatwg.org/#has-an-element-in-table-scope
 	 *
 	 * @param string $tag_name Name of tag to check.
 	 * @return bool Whether given element is in scope.
@@ -470,7 +470,7 @@ public function has_element_in_table_scope( string $tag_name ): bool {
 	 * @since 6.4.0 Stub implementation (throws).
 	 * @since 6.7.0 Full implementation.
 	 *
-	 * @see https://html.spec.whatwg.org/#has-an-element-in-select-scope
+	 * @link https://html.spec.whatwg.org/#has-an-element-in-select-scope
 	 *
 	 * @param string $tag_name Name of tag to check.
 	 * @return bool Whether the given element is in SELECT scope.
@@ -497,7 +497,7 @@ public function has_element_in_select_scope( string $tag_name ): bool {
 	 *
 	 * @since 6.4.0
 	 *
-	 * @see https://html.spec.whatwg.org/#has-an-element-in-button-scope
+	 * @link https://html.spec.whatwg.org/#has-an-element-in-button-scope
 	 *
 	 * @return bool Whether a P is in BUTTON scope.
 	 */
@@ -510,7 +510,7 @@ public function has_p_in_button_scope(): bool {
 	 *
 	 * @since 6.4.0
 	 *
-	 * @see https://html.spec.whatwg.org/#stack-of-open-elements
+	 * @link https://html.spec.whatwg.org/#stack-of-open-elements
 	 *
 	 * @return bool Whether a node was popped off of the stack.
 	 */