diff --git a/src/wp-includes/class-wp-http-requests-hooks.php b/src/wp-includes/class-wp-http-requests-hooks.php index 80e4eb7ef4b9f..541ccc9a661a1 100644 --- a/src/wp-includes/class-wp-http-requests-hooks.php +++ b/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 * 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/compat-utf8.php b/src/wp-includes/compat-utf8.php index 20ebdfc3144e7..daeabb932b8e4 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 3ac1372fdca1e..fa5340b61e3c9 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 @@ -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 * 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 360acf5d4689f..2b6ad4c8feea5 100644 --- a/src/wp-includes/deprecated.php +++ b/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' ); diff --git a/src/wp-includes/global-styles-and-settings.php b/src/wp-includes/global-styles-and-settings.php index d50ee14e22015..c19140012c2e0 100644 --- a/src/wp-includes/global-styles-and-settings.php +++ b/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; diff --git a/src/wp-includes/html-api/class-wp-html-active-formatting-elements.php b/src/wp-includes/html-api/class-wp-html-active-formatting-elements.php index 2f51482eee052..264eb12b19da4 100644 --- a/src/wp-includes/html-api/class-wp-html-active-formatting-elements.php +++ b/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 */ diff --git a/src/wp-includes/html-api/class-wp-html-decoder.php b/src/wp-includes/html-api/class-wp-html-decoder.php index bd62f311aef13..851f81832b859 100644 --- a/src/wp-includes/html-api/class-wp-html-decoder.php +++ b/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. diff --git a/src/wp-includes/html-api/class-wp-html-doctype-info.php b/src/wp-includes/html-api/class-wp-html-doctype-info.php index 1e57afb3fd550..b3c95aae42cd4 100644 --- a/src/wp-includes/html-api/class-wp-html-doctype-info.php +++ b/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 { * * ╰──┴── 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 ]; diff --git a/src/wp-includes/html-api/class-wp-html-open-elements.php b/src/wp-includes/html-api/class-wp-html-open-elements.php index 210492ab9af08..bb0655c8714b0 100644 --- a/src/wp-includes/html-api/class-wp-html-open-elements.php +++ b/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. */ diff --git a/src/wp-includes/html-api/class-wp-html-processor-state.php b/src/wp-includes/html-api/class-wp-html-processor-state.php index b257aa809da75..779ac35fcab0b 100644 --- a/src/wp-includes/html-api/class-wp-html-processor-state.php +++ b/src/wp-includes/html-api/class-wp-html-processor-state.php @@ -32,7 +32,7 @@ class WP_HTML_Processor_State { * is added to the parser for more modes, add them here * following the same naming and value pattern. * - * @see https://html.spec.whatwg.org/#the-insertion-mode + * @link https://html.spec.whatwg.org/#the-insertion-mode */ /** @@ -40,7 +40,7 @@ class WP_HTML_Processor_State { * * @since 6.4.0 * - * @see https://html.spec.whatwg.org/#the-initial-insertion-mode + * @link https://html.spec.whatwg.org/#the-initial-insertion-mode * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -52,7 +52,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#the-before-html-insertion-mode + * @link https://html.spec.whatwg.org/#the-before-html-insertion-mode * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -64,7 +64,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-beforehead + * @link https://html.spec.whatwg.org/#parsing-main-beforehead * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -76,7 +76,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-inhead + * @link https://html.spec.whatwg.org/#parsing-main-inhead * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -88,7 +88,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-inheadnoscript + * @link https://html.spec.whatwg.org/#parsing-main-inheadnoscript * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -100,7 +100,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-afterhead + * @link https://html.spec.whatwg.org/#parsing-main-afterhead * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -112,7 +112,7 @@ class WP_HTML_Processor_State { * * @since 6.4.0 * - * @see https://html.spec.whatwg.org/#parsing-main-inbody + * @link https://html.spec.whatwg.org/#parsing-main-inbody * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -124,7 +124,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-intable + * @link https://html.spec.whatwg.org/#parsing-main-intable * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -136,7 +136,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-intabletext + * @link https://html.spec.whatwg.org/#parsing-main-intabletext * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -148,7 +148,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-incaption + * @link https://html.spec.whatwg.org/#parsing-main-incaption * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -160,7 +160,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-incolumngroup + * @link https://html.spec.whatwg.org/#parsing-main-incolumngroup * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -172,7 +172,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-intablebody + * @link https://html.spec.whatwg.org/#parsing-main-intablebody * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -184,7 +184,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-inrow + * @link https://html.spec.whatwg.org/#parsing-main-inrow * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -196,7 +196,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-incell + * @link https://html.spec.whatwg.org/#parsing-main-incell * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -208,7 +208,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-inselect + * @link https://html.spec.whatwg.org/#parsing-main-inselect * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -220,7 +220,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-inselectintable + * @link https://html.spec.whatwg.org/#parsing-main-inselectintable * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -232,7 +232,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-intemplate + * @link https://html.spec.whatwg.org/#parsing-main-intemplate * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -244,7 +244,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-afterbody + * @link https://html.spec.whatwg.org/#parsing-main-afterbody * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -256,7 +256,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-inframeset + * @link https://html.spec.whatwg.org/#parsing-main-inframeset * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -268,7 +268,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#parsing-main-afterframeset + * @link https://html.spec.whatwg.org/#parsing-main-afterframeset * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -280,7 +280,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#the-after-after-body-insertion-mode + * @link https://html.spec.whatwg.org/#the-after-after-body-insertion-mode * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -292,7 +292,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#the-after-after-frameset-insertion-mode + * @link https://html.spec.whatwg.org/#the-after-after-frameset-insertion-mode * @see WP_HTML_Processor_State::$insertion_mode * * @var string @@ -304,7 +304,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/#the-insertion-mode:stack-of-template-insertion-modes + * @link https://html.spec.whatwg.org/#the-insertion-mode:stack-of-template-insertion-modes * * @var array */ @@ -317,7 +317,7 @@ class WP_HTML_Processor_State { * * @since 6.4.0 * - * @see https://html.spec.whatwg.org/#stack-of-open-elements + * @link https://html.spec.whatwg.org/#stack-of-open-elements * * @var WP_HTML_Open_Elements */ @@ -330,7 +330,7 @@ class WP_HTML_Processor_State { * * @since 6.4.0 * - * @see https://html.spec.whatwg.org/#list-of-active-formatting-elements + * @link https://html.spec.whatwg.org/#list-of-active-formatting-elements * * @var WP_HTML_Active_Formatting_Elements */ @@ -350,7 +350,7 @@ class WP_HTML_Processor_State { * * @since 6.4.0 * - * @see https://html.spec.whatwg.org/#insertion-mode + * @link https://html.spec.whatwg.org/#insertion-mode * * @var string */ @@ -403,7 +403,7 @@ class WP_HTML_Processor_State { * * @since 6.7.0 * - * @see https://html.spec.whatwg.org/multipage/parsing.html#head-element-pointer + * @link https://html.spec.whatwg.org/multipage/parsing.html#head-element-pointer * * @var WP_HTML_Token|null */ @@ -419,7 +419,7 @@ class WP_HTML_Processor_State { * * @todo This may be invalidated by a seek operation. * - * @see https://html.spec.whatwg.org/#form-element-pointer + * @link https://html.spec.whatwg.org/#form-element-pointer * * @since 6.7.0 * @@ -434,7 +434,7 @@ class WP_HTML_Processor_State { * * @since 6.4.0 * - * @see https://html.spec.whatwg.org/#frameset-ok-flag + * @link https://html.spec.whatwg.org/#frameset-ok-flag * * @var bool */ diff --git a/src/wp-includes/html-api/class-wp-html-processor.php b/src/wp-includes/html-api/class-wp-html-processor.php index 55f955f2c1a9a..c5f32560b6aee 100644 --- a/src/wp-includes/html-api/class-wp-html-processor.php +++ b/src/wp-includes/html-api/class-wp-html-processor.php @@ -467,7 +467,7 @@ function ( WP_HTML_Token $token ): void { * fragment. Special care must be taken when processing fragments that are expected to appear * in specific contexts. SVG and TABLE are good examples, but there are others. * - * @see https://html.spec.whatwg.org/multipage/parsing.html#html-fragment-parsing-algorithm + * @link https://html.spec.whatwg.org/multipage/parsing.html#html-fragment-parsing-algorithm * * @since 6.8.0 * diff --git a/src/wp-includes/html-api/class-wp-html-tag-processor.php b/src/wp-includes/html-api/class-wp-html-tag-processor.php index 69e3e5d2c7557..2ce16fb7a5c74 100644 --- a/src/wp-includes/html-api/class-wp-html-tag-processor.php +++ b/src/wp-includes/html-api/class-wp-html-tag-processor.php @@ -1383,7 +1383,7 @@ public function release_bookmark( $name ): bool { * * @since 6.3.2 * - * @see https://html.spec.whatwg.org/#generic-raw-text-element-parsing-algorithm + * @link https://html.spec.whatwg.org/#generic-raw-text-element-parsing-algorithm * * @param string $tag_name The uppercase tag name which will close the RAWTEXT region. * @return bool Whether an end to the RAWTEXT region was found before the end of the document. @@ -1402,7 +1402,7 @@ private function skip_rawtext( string $tag_name ): bool { * * @since 6.2.0 * - * @see https://html.spec.whatwg.org/multipage/parsing.html#rcdata-state + * @link https://html.spec.whatwg.org/multipage/parsing.html#rcdata-state * * @param string $tag_name The uppercase tag name which will close the RCDATA region. * @return bool Whether an end to the RCDATA region was found before the end of the document. @@ -1631,17 +1631,17 @@ private function skip_script_data(): bool { /** * These characters trigger state transitions of interest: * - * - @see {https://html.spec.whatwg.org/multipage/parsing.html#script-data-end-tag-name-state} - * - @see {https://html.spec.whatwg.org/multipage/parsing.html#script-data-escaped-end-tag-name-state} - * - @see {https://html.spec.whatwg.org/multipage/parsing.html#script-data-double-escape-start-state} - * - @see {https://html.spec.whatwg.org/multipage/parsing.html#script-data-double-escape-end-state} + * - @link https://html.spec.whatwg.org/multipage/parsing.html#script-data-end-tag-name-state + * - @link https://html.spec.whatwg.org/multipage/parsing.html#script-data-escaped-end-tag-name-state + * - @link https://html.spec.whatwg.org/multipage/parsing.html#script-data-double-escape-start-state + * - @link https://html.spec.whatwg.org/multipage/parsing.html#script-data-double-escape-end-state * * The "\r" character is not present in the above references. However, "\r" must be * treated the same as "\n". This is because the HTML Standard requires newline * normalization during preprocessing which applies this replacement. * - * - @see https://html.spec.whatwg.org/multipage/parsing.html#preprocessing-the-input-stream - * - @see https://infra.spec.whatwg.org/#normalize-newlines + * - @link https://html.spec.whatwg.org/multipage/parsing.html#preprocessing-the-input-stream + * - @link https://infra.spec.whatwg.org/#normalize-newlines */ '>' !== $c && ' ' !== $c && @@ -1729,7 +1729,7 @@ private function parse_next_tag(): bool { * At this point the parser checks if this is one of those cases and if it is * will continue searching for the next "<" in search of a token boundary. * - * @see https://html.spec.whatwg.org/#tag-open-state + * @link https://html.spec.whatwg.org/#tag-open-state */ if ( 1 !== strspn( $html, '!/?abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ', $at + 1, 1 ) ) { ++$at; @@ -2050,7 +2050,7 @@ private function parse_next_tag(): bool { * @todo Processing instruction nodes in SGML may contain any kind of markup. XML defines a * special case with `` syntax, but the `?` is part of the bogus comment. * - * @see https://www.w3.org/TR/2006/REC-xml11-20060816/#NT-PITarget + * @link https://www.w3.org/TR/2006/REC-xml11-20060816/#NT-PITarget */ if ( $this->token_length >= 5 && '?' === $html[ $closer_at - 1 ] ) { $comment_text = substr( $html, $this->token_starts_at + 2, $this->token_length - 4 ); @@ -2140,7 +2140,7 @@ private function parse_next_attribute(): bool { * Treat the equal sign as a part of the attribute * name if it is the first encountered byte. * - * @see https://html.spec.whatwg.org/multipage/parsing.html#before-attribute-name-state + * @link https://html.spec.whatwg.org/multipage/parsing.html#before-attribute-name-state */ $name_length = '=' === $this->html[ $this->bytes_already_parsed ] ? 1 + strcspn( $this->html, "=/> \t\f\r\n", $this->bytes_already_parsed + 1 ) @@ -2217,7 +2217,7 @@ private function parse_next_attribute(): bool { * > case-insensitive match for each other. * - HTML 5 spec * - * @see https://html.spec.whatwg.org/multipage/syntax.html#attributes-2:ascii-case-insensitive + * @link https://html.spec.whatwg.org/multipage/syntax.html#attributes-2:ascii-case-insensitive */ $comparable_name = strtolower( $attribute_name ); @@ -2830,7 +2830,7 @@ public function get_attribute( $name ) { * * @since 6.2.0 * - * @see https://html.spec.whatwg.org/multipage/syntax.html#attributes-2:ascii-case-insensitive + * @link https://html.spec.whatwg.org/multipage/syntax.html#attributes-2:ascii-case-insensitive * * @param string $prefix Prefix of requested attribute names. * @return array|null List of attribute names, or `null` when no tag opener is matched. @@ -3347,7 +3347,7 @@ public function is_tag_closer(): bool { * appears then the HTML parser will treat it as an opening tag with no * attributes. The BR tag is unique in this way. * - * @see https://html.spec.whatwg.org/#parsing-main-inbody + * @link https://html.spec.whatwg.org/#parsing-main-inbody */ 'BR' !== $this->get_tag() ); @@ -3646,8 +3646,8 @@ public function get_modifiable_text(): string { * it's important to apply the pre-processing steps, which is * normalizing newlines. * - * @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 */ $text = str_replace( "\r\n", "\n", $text ); $text = str_replace( "\r", "\n", $text ); @@ -3912,7 +3912,7 @@ static function ( $tag_match ) { * * Only 'javascript' and 'json' content types are currently recognized. * - * @see https://html.spec.whatwg.org/multipage/scripting.html#prepare-the-script-element + * @link https://html.spec.whatwg.org/multipage/scripting.html#prepare-the-script-element * * @since 7.0.0 * @@ -3980,8 +3980,8 @@ private function get_script_content_type(): ?string { * > - text/x-ecmascript * > - text/x-javascript * - * @see https://mimesniff.spec.whatwg.org/#javascript-mime-type-essence-match - * @see https://mimesniff.spec.whatwg.org/#javascript-mime-type + * @link https://mimesniff.spec.whatwg.org/#javascript-mime-type-essence-match + * @link https://mimesniff.spec.whatwg.org/#javascript-mime-type */ switch ( $type_string ) { case 'application/ecmascript': @@ -4183,8 +4183,8 @@ private function get_script_content_type(): ?string { * as “tag-name-terminating characters.” This sequence forms the start * of what could be a SCRIPT opening or closing tag. * - * @see https://html.spec.whatwg.org/#restrictions-for-contents-of-script-elements - * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals#specifications + * @link https://html.spec.whatwg.org/#restrictions-for-contents-of-script-elements + * @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals#specifications * @see wp_html_api_script_element_escaping_diagram_source() * * @since 7.0.0 @@ -4292,7 +4292,7 @@ public function set_attribute( $name, $value ): bool { * - greater-than “>” * - ampersand “&” * - * @see https://html.spec.whatwg.org/#attributes-2 + * @link https://html.spec.whatwg.org/#attributes-2 */ if ( 0 === $name_length || @@ -4333,7 +4333,7 @@ public function set_attribute( $name, $value ): bool { /** * Escape attribute values appropriately. * - * @see https://html.spec.whatwg.org/#attributes-3 + * @link https://html.spec.whatwg.org/#attributes-3 */ $escaped_new_value = in_array( $comparable_name, wp_kses_uri_attributes(), true ) ? esc_url( $value ) @@ -4362,7 +4362,7 @@ public function set_attribute( $name, $value ): bool { * > case-insensitive match for each other. * - HTML 5 spec * - * @see https://html.spec.whatwg.org/multipage/syntax.html#attributes-2:ascii-case-insensitive + * @link https://html.spec.whatwg.org/multipage/syntax.html#attributes-2:ascii-case-insensitive */ $comparable_name = strtolower( $name ); @@ -4438,7 +4438,7 @@ public function remove_attribute( $name ): bool { * > case-insensitive match for each other. * - HTML 5 spec * - * @see https://html.spec.whatwg.org/multipage/syntax.html#attributes-2:ascii-case-insensitive + * @link https://html.spec.whatwg.org/multipage/syntax.html#attributes-2:ascii-case-insensitive */ $name = strtolower( $name ); @@ -4975,7 +4975,7 @@ public function get_doctype_info(): ?WP_HTML_Doctype_Info { * > described by the modern HTML and CSS specifications. * * @see self::$compat_mode - * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode + * @link https://developer.mozilla.org/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode * * @since 6.7.0 * @@ -4991,7 +4991,7 @@ public function get_doctype_info(): ?WP_HTML_Doctype_Info { * > built before the widespread adoption of web standards. * * @see self::$compat_mode - * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode + * @link https://developer.mozilla.org/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode * * @since 6.7.0 * diff --git a/src/wp-includes/html-api/class-wp-html-token.php b/src/wp-includes/html-api/class-wp-html-token.php index d5e51ac29007f..44ce93c107567 100644 --- a/src/wp-includes/html-api/class-wp-html-token.php +++ b/src/wp-includes/html-api/class-wp-html-token.php @@ -54,7 +54,7 @@ class WP_HTML_Token { * * @since 6.4.0 * - * @see https://html.spec.whatwg.org/#self-closing-flag + * @link https://html.spec.whatwg.org/#self-closing-flag * * @var bool */ diff --git a/src/wp-includes/media.php b/src/wp-includes/media.php index 5d350b1a18951..8834c3d17aa45 100644 --- a/src/wp-includes/media.php +++ b/src/wp-includes/media.php @@ -2088,9 +2088,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 d90fdfa8061ab..e48fa8795a111 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 2dbdd584b385d..05229149249c9 100644 --- a/src/wp-includes/pluggable.php +++ b/src/wp-includes/pluggable.php @@ -2381,7 +2381,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/tickets/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 87689423c37ac..7bf7231c8516a 100644 --- a/src/wp-includes/script-loader.php +++ b/src/wp-includes/script-loader.php @@ -171,7 +171,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 * @@ -4009,7 +4009,7 @@ public function remove() { * * @since 6.9.0 * - * @see https://html.spec.whatwg.org/#concept-domstringmap-pairs + * @link https://html.spec.whatwg.org/#concept-domstringmap-pairs * @see \wp_html_custom_data_attribute_name() * * @param string $html_attribute_name Raw attribute name as found in the source HTML. @@ -4036,7 +4036,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; @@ -4087,7 +4087,7 @@ function wp_js_dataset_name( string $html_attribute_name ): ?string { * * @since 6.9.0 * - * @see https://html.spec.whatwg.org/#concept-domstringmap-pairs + * @link https://html.spec.whatwg.org/#concept-domstringmap-pairs * @see \wp_js_dataset_name() * * @param string $js_dataset_name Name of JS `dataset` property to transform. diff --git a/src/wp-includes/speculative-loading.php b/src/wp-includes/speculative-loading.php index 319e04d36ddde..488a7a2e403a4 100644 --- a/src/wp-includes/speculative-loading.php +++ b/src/wp-includes/speculative-loading.php @@ -43,7 +43,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 53627612f9504..5d1e5bfa95d30 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/utf8.php b/src/wp-includes/utf8.php index da10838f233d1..8fb92fd6c6945 100644 --- a/src/wp-includes/utf8.php +++ b/src/wp-includes/utf8.php @@ -147,9 +147,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 *