Make WordPress Core


Ignore:
Timestamp:
08/17/2026 01:13:55 PM (3 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.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-includes/block-editor.php

    r63177 r63320  
    110110 *
    111111 * @param WP_Block_Editor_Context $block_editor_context The current block editor context.
    112  *
    113112 * @return bool|string[] Array of block type slugs, or boolean to enable/disable all.
    114113 */
    … …  
    485484 * @param array                   $custom_settings      Custom settings to use with the given editor type.
    486485 * @param WP_Block_Editor_Context $block_editor_context The current block editor context.
    487  *
    488486 * @return array The contextualized block editor settings.
    489487 */
Note: See TracChangeset for help on using the changeset viewer.