WordPress.org
Get WordPress

Make WordPress Core

Changeset 63790


Ignore:
Timestamp:
09/22/2026 04:05:00 AM (16 hours ago)
Author:
wildworks
Message:

Docs: Add missing @since tags to several core classes.

Adds @since tags to 27 functions, methods, properties, and class constants across ten files that had no version tag at all.

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

Props mukesh27, som9663, wildworks.
See #65860.

Location:
trunk/src/wp-includes
Files:
15 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-includes/block-supports/custom-css.php

    r63529 r63790  
    158158 * Registers the style block attribute for block types that support it.
    159159 *
     160 * @since 7.0.0
     161 *
    160162 * @param WP_Block_Type $block_type Block Type.
    161163 */

  • trunk/src/wp-includes/class-wp-block-processor.php

    r63630 r63790  
    539539         * when processing HTML spans, so there’s no need to track them independently.
    540540         *
     541         * @since 6.9.0
    541542         * @var 'push'|'void'|'pop'|null
    542543         */
    … …  
    14431444         *     $is_formula        = $processor->is_block_type( 'math-block/formula' );
    14441445         *
     1446         * @since 6.9.0
     1447         *
    14451448         * @param string $block_type Block type name for the desired block.
    14461449         *                           E.g. "paragraph", "core/paragraph", "math-blocks/formula".

  • trunk/src/wp-includes/class-wp-theme-json.php

    r63641 r63790  
    955955         * Processes pseudo-selectors for any node (block or variation).
    956956         *
     957         * @since 7.0.0
     958         *
    957959         * @param array      $node            The node data (block or variation).
    958960         * @param string     $base_selector   The base selector.

  • trunk/src/wp-includes/class-wp-token-map.php

    r63320 r63790  
    152152         * corresponds to the WordPress release will help people identify where an
    153153         * old copy of data came from.
     154         *
     155         * @since 6.6.0
    154156         */
    155157        const STORAGE_VERSION = '6.6.0-trunk';
    … …  
    644646         *     );
    645647         *
     648         * @since 6.6.0
     649         *
    646650         * @return array The lookup key/substitution values as an associate array.
    647651         */

  • trunk/src/wp-includes/html-api/class-wp-html-processor.php

    r63463 r63790  
    258258         * Context node if created as a fragment parser.
    259259         *
     260         * @since 6.6.0
    260261         * @var WP_HTML_Token|null
    261262         */
    … …  
    51335134        /**
    51345135         * Indicates the namespace of the current token, or "html" if there is none.
     5136         *
     5137         * @since 6.7.0
    51355138         *
    51365139         * @return string One of "html", "math", or "svg".
    … …  
    66526655         * doing so with a full understanding that it's intended to be a private API.
    66536656         *
     6657         * @since 6.4.0
    66546658         * @access private
    66556659         */

  • trunk/src/wp-includes/html-api/class-wp-html-tag-processor.php

    r63656 r63790  
    690690         * Whether the current tag is an opening tag, e.g. <div>, or a closing tag, e.g. </div>.
    691691         *
     692         * @since 6.2.0
    692693         * @var bool
    693694         */
    … …  
    13811382         * Releasing a bookmark frees up the small
    13821383         * performance overhead it requires.
     1384         *
     1385         * @since 6.2.0
    13831386         *
    13841387         * @param string $name Name of the bookmark to remove.
    … …  
    50875090         * its information.
    50885091         *
     5092         * @since 6.7.0
     5093         *
    50895094         * @return WP_HTML_Doctype_Info|null The DOCTYPE declaration information or `null` if not
    50905095         *                                   currently at a DOCTYPE node.

  • trunk/src/wp-includes/html-api/class-wp-html-token.php

    r62507 r63790  
    8282         * Called when token is garbage-collected or otherwise destroyed.
    8383         *
     84         * @since 6.4.0
    8485         * @var callable|null
    8586         */

  • trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-block-directory-controller.php

    r63567 r63790  
    1919        /**
    2020         * Constructs the controller.
     21         *
     22         * @since 5.5.0
    2123         */
    2224        public function __construct() {
    … …  
    2729        /**
    2830         * Registers the necessary REST API routes.
     31         *
     32         * @since 5.5.0
    2933         */
    3034        public function register_routes() {

  • trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php

    r63675 r63790  
    21682168         * Check if post type supports notes.
    21692169         *
     2170         * @since 6.9.0
     2171         *
    21702172         * @param string $post_type Post type name.
    21712173         * @return bool True if post type supports notes, false otherwise.

  • trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-font-faces-controller.php

    r61765 r63790  
    1010/**
    1111 * Class to access font faces through the REST API.
     12 *
     13 * @since 6.5.0
    1214 */
    1315class WP_REST_Font_Faces_Controller extends WP_REST_Posts_Controller {

  • trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-font-families-controller.php

    r61765 r63790  
    497497         * Prepares child font face links for the request.
    498498         *
     499         * @since 6.5.0
     500         *
    499501         * @param int $font_family_id Font family post ID.
    500502         * @return array Links for the child font face posts.

  • trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-global-styles-controller.php

    r63596 r63790  
    1010/**
    1111 * Base Global Styles REST API Controller.
     12 *
     13 * @since 5.9.0
    1214 */
    1315class WP_REST_Global_Styles_Controller extends WP_REST_Posts_Controller {

  • trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-search-controller.php

    r59970 r63790  
    1919        /**
    2020         * ID property name.
     21         *
     22         * @since 5.0.0
    2123         */
    2224        const PROP_ID = 'id';
    … …  
    2426        /**
    2527         * Title property name.
     28         *
     29         * @since 5.0.0
    2630         */
    2731        const PROP_TITLE = 'title';
    … …  
    2933        /**
    3034         * URL property name.
     35         *
     36         * @since 5.0.0
    3137         */
    3238        const PROP_URL = 'url';
    … …  
    3440        /**
    3541         * Type property name.
     42         *
     43         * @since 5.0.0
    3644         */
    3745        const PROP_TYPE = 'type';
    … …  
    3947        /**
    4048         * Subtype property name.
     49         *
     50         * @since 5.0.0
    4151         */
    4252        const PROP_SUBTYPE = 'subtype';
    … …  
    4454        /**
    4555         * Identifier for the 'any' type.
     56         *
     57         * @since 5.0.0
    4658         */
    4759        const TYPE_ANY = 'any';

  • trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php

    r61856 r63790  
    2020         * Matches theme's directory: `/themes/<subdirectory>/<theme>/` or `/themes/<theme>/`.
    2121         * Excludes invalid directory name characters: `/:<>*?"|`.
     22         *
     23         * @since 5.9.0
    2224         */
    2325        const PATTERN = '[^\/:<>\*\?"\|]+(?:\/[^\/:<>\*\?"\|]+)?';

  • trunk/src/wp-includes/sitemaps/class-wp-sitemaps-stylesheet.php

    r62704 r63790  
    1919        /**
    2020         * Renders the XSL stylesheet depending on whether it's the sitemap index or not.
     21         *
     22         * @since 5.5.0
    2123         *
    2224         * @param string $type Stylesheet type. Either 'sitemap' or 'index'.
Note: See TracChangeset for help on using the changeset viewer.