Skip to content

Used @link for url in inline documentation #80716

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
shail-mehta merged 1 commit into from
Jul 26, 2026
Merged

Used @link for url in inline documentation #80716

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions lib/class-wp-theme-json-gutenberg.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1470,7 +1470,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 str_replace( ',', $to_append . ',', $selector ) . $to_append;
Expand Down Expand Up @@ -1519,7 +1519,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 . str_replace( ',', ',' . $to_prepend, $selector );
Expand Down Expand Up @@ -1565,8 +1565,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/
*
* @param string $selector CSS selector list.
* @return string[] Selectors.
Expand Down Expand Up @@ -1671,8 +1671,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;
Expand Down
2 changes: 1 addition & 1 deletion lib/compat/plugin/edit-site-routes-backwards-compat.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
* consumer code might still be referencing them. In order to not break the Site Editor
* flows, we don't fully remove the old routes, but redirect them to the core's one.
*
* @see https://github.com/WordPress/gutenberg/pull/41306
* @link https://github.com/WordPress/gutenberg/pull/41306
*
* @package gutenberg
*/
Expand Down
2 changes: 1 addition & 1 deletion lib/compat/plugin/fonts.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
/**
* A special compat layer for legacy font files upload directory.
*
* @see https://github.com/WordPress/gutenberg/pull/57688#issuecomment-2259037546
* @link https://github.com/WordPress/gutenberg/pull/57688#issuecomment-2259037546
*
* @package gutenberg
*/
Expand Down
18 changes: 9 additions & 9 deletions lib/experimental/navigation-theme-opt-in.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@
* This shim can be removed when the Gutenberg plugin requires a WordPress
* version that has the ticket below.
*
* @see https://core.trac.wordpress.org/ticket/50544
* @link https://core.trac.wordpress.org/ticket/50544
*
* @global WP_Customize_Manager $wp_customize
*
Expand Down Expand Up @@ -82,7 +82,7 @@ function gutenberg_update_nav_menu_item_content( $menu_id, $menu_item_db_id, $ar
* This shim can be removed when the Gutenberg plugin requires a WordPress
* version that has the ticket below.
*
* @see https://core.trac.wordpress.org/ticket/50544
* @link https://core.trac.wordpress.org/ticket/50544
*
* @param object $menu_item The menu item object.
*
Expand Down Expand Up @@ -115,7 +115,7 @@ function gutenberg_setup_block_nav_menu_item( $menu_item ) {
* This shim can be removed when the Gutenberg plugin requires a WordPress
* version that has the ticket below.
*
* @see https://core.trac.wordpress.org/ticket/50544
* @link https://core.trac.wordpress.org/ticket/50544
*
* @param string $item_output The menu item's starting HTML output.
* @param WP_Post $item Menu item data object.
Expand Down Expand Up @@ -147,15 +147,15 @@ function gutenberg_output_block_nav_menu_item( $item_output, $item, $depth, $arg
* This shim can be removed when the Gutenberg plugin requires a WordPress
* version that has the ticket below.
*
* @see https://core.trac.wordpress.org/ticket/50544
* @link https://core.trac.wordpress.org/ticket/50544
*
* @param array $menu_items The menu items, sorted by each menu item's menu order.
*
* @return array Updated menu items, sorted by each menu item's menu order.
*/
function gutenberg_remove_block_nav_menu_items( $menu_items ) {
// We should uncomment the line below when the block-nav-menus feature becomes stable.
// @see https://github.com/WordPress/gutenberg/issues/34265.
// @link https://github.com/WordPress/gutenberg/issues/34265.
/*if ( current_theme_supports( 'block-nav-menus' ) ) {*/
if ( false ) {
return $menu_items;
Expand Down Expand Up @@ -241,7 +241,7 @@ function gutenberg_convert_menu_items_to_blocks(
* This shim can be removed when the Gutenberg plugin requires a WordPress
* version that has the ticket below.
*
* @see https://core.trac.wordpress.org/ticket/50544
* @link https://core.trac.wordpress.org/ticket/50544
*
* @param string|null $output Nav menu output to short-circuit with. Default null.
* @param stdClass $args An object containing wp_nav_menu() arguments.
Expand All @@ -250,7 +250,7 @@ function gutenberg_convert_menu_items_to_blocks(
*/
function gutenberg_output_block_nav_menu( $output, $args ) {
// We should uncomment the line below when the block-nav-menus feature becomes stable.
// @see https://github.com/WordPress/gutenberg/issues/34265.
// @link https://github.com/WordPress/gutenberg/issues/34265.
/*if ( ! current_theme_supports( 'block-nav-menus' ) ) {*/
if ( true ) {
return null;
Expand Down Expand Up @@ -331,7 +331,7 @@ function gutenberg_output_block_nav_menu( $output, $args ) {
* This shim can be removed when the Gutenberg plugin requires a WordPress
* version that has the ticket below.
*
* @see https://core.trac.wordpress.org/ticket/50544
* @link https://core.trac.wordpress.org/ticket/50544
*
* @param int $item_id Menu item ID.
* @param WP_Post $item Menu item data object.
Expand All @@ -358,7 +358,7 @@ function gutenberg_output_block_menu_item_custom_fields( $item_id, $item ) {
* This shim can be removed when the Gutenberg plugin requires a WordPress
* version that has the ticket below.
*
* @see https://core.trac.wordpress.org/ticket/50544
* @link https://core.trac.wordpress.org/ticket/50544
*
* @param string $hook The current admin page.
*/
Expand Down
Loading