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/blocks.php

    r63171 r63320  
    624624                         * @param string   $content    Block default content.
    625625                         * @param WP_Block $block      Block instance.
    626                          *
    627626                         * @return string Returns the block content.
    628627                         */
    … …  
    19301929 *
    19311930 * @param array $blocks An array blocks.
    1932  *
    19331931 * @return array An array of blocks with patterns replaced by their content.
    19341932 */
    … …  
    28152813 * @param WP_Block $block Block instance.
    28162814 * @param int      $page  Current query's page.
    2817  *
    28182815 * @return array Returns the constructed WP_Query arguments.
    28192816 */
Note: See TracChangeset for help on using the changeset viewer.