Changeset 63320

Timestamp:

08/17/2026 01:13:55 PM (2 months ago)

Author:

SergeyBiryukov

Message:

Docs: Remove a blank line between @param and @return in core docblocks.

The ​PHP inline documentation standards place @return immediately after the last @param tag, with no blank line between them:

/**
 * Summary.
 *
 * @since x.x.x
 *
 * @param string $var Description.
 * @return string Description.
 */

This corrects 44 docblocks across 33 files in src/wp-includes that used a line break between the two tags.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/13063.

Props mukesh27, dhruvang21.
See #65818, #65860.

Location:

trunk/src/wp-includes

Files:

• block-editor.php (modified) (view diffs)
• block-supports/aria-label.php (modified) (view diffs)
• block-supports/block-style-variations.php (modified) (view diffs)
• block-supports/colors.php (modified) (view diffs)
• block-supports/custom-classname.php (modified) (view diffs)
• block-supports/settings.php (modified) (view diffs)
• block-supports/utils.php (modified) (view diffs)
• block-template-utils.php (modified) (view diffs)
• block-template.php (modified) (view diffs)
• blocks.php (modified) (view diffs)
• class-wp-block-type.php (modified) (view diffs)
• class-wp-term-query.php (modified) (view diffs)
• class-wp-textdomain-registry.php (modified) (view diffs)
• class-wp-theme-json-data.php (modified) (view diffs)
• class-wp-theme-json-schema.php (modified) (view diffs)
• class-wp-token-map.php (modified) (view diffs)
• deprecated.php (modified) (view diffs)
• functions.php (modified) (view diffs)
• global-styles-and-settings.php (modified) (view diffs)
• html-api/class-wp-html-doctype-info.php (modified) (view diffs)
• html-api/class-wp-html-processor.php (modified) (view diffs)
• html-api/class-wp-html-tag-processor.php (modified) (view diffs)
• kses.php (modified) (view diffs)
• l10n.php (modified) (view diffs)
• rest-api.php (modified) (view diffs)
• rest-api/class-wp-rest-server.php (modified) (view diffs)
• rest-api/endpoints/class-wp-rest-global-styles-controller.php (modified) (view diffs)
• rest-api/endpoints/class-wp-rest-menu-items-controller.php (modified) (view diffs)
• rest-api/endpoints/class-wp-rest-widget-types-controller.php (modified) (view diffs)
• script-loader.php (modified) (view diffs)
• sitemaps/providers/class-wp-sitemaps-posts.php (modified) (view diffs)
• theme.php (modified) (view diffs)
• user.php (modified) (view diffs)