Commit 727a70a948 for wordpress.org
commit 727a70a94806b436add3cd218c941aa981fcd466
Author: wildworks <wildworks@git.wordpress.org>
Date: Tue Sep 22 04:05:48 2026 +0000
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.
Built from https://develop.svn.wordpress.org/trunk@63790
git-svn-id: http://core.svn.wordpress.org/trunk@62962 1a063a9b-81f0-0310-95a4-ce76da25c4cd
diff --git a/wp-includes/block-supports/custom-css.php b/wp-includes/block-supports/custom-css.php
index 50d21d4063..66fd9469dd 100644
--- a/wp-includes/block-supports/custom-css.php
+++ b/wp-includes/block-supports/custom-css.php
@@ -157,6 +157,8 @@ add_action( 'wp_enqueue_scripts', 'wp_enqueue_block_custom_css', 1 );
/**
* Registers the style block attribute for block types that support it.
*
+ * @since 7.0.0
+ *
* @param WP_Block_Type $block_type Block Type.
*/
function wp_register_custom_css_support( $block_type ) {
diff --git a/wp-includes/class-wp-block-processor.php b/wp-includes/class-wp-block-processor.php
index 7c22dc1ea8..7b35b6aff3 100644
--- a/wp-includes/class-wp-block-processor.php
+++ b/wp-includes/class-wp-block-processor.php
@@ -538,6 +538,7 @@ class WP_Block_Processor {
* associated with token boundaries still point to the delimiters even
* when processing HTML spans, so there’s no need to track them independently.
*
+ * @since 6.9.0
* @var 'push'|'void'|'pop'|null
*/
private $next_stack_op = null;
@@ -1442,6 +1443,8 @@ class WP_Block_Processor {
* $is_core_paragraph = $processor->is_block_type( 'core/paragraph' );
* $is_formula = $processor->is_block_type( 'math-block/formula' );
*
+ * @since 6.9.0
+ *
* @param string $block_type Block type name for the desired block.
* E.g. "paragraph", "core/paragraph", "math-blocks/formula".
* @return bool Whether this delimiter represents a block of the given type.
diff --git a/wp-includes/class-wp-theme-json.php b/wp-includes/class-wp-theme-json.php
index 087c215e56..d61e8e2a91 100644
--- a/wp-includes/class-wp-theme-json.php
+++ b/wp-includes/class-wp-theme-json.php
@@ -954,6 +954,8 @@ class WP_Theme_JSON {
/**
* Processes pseudo-selectors for any node (block or variation).
*
+ * @since 7.0.0
+ *
* @param array $node The node data (block or variation).
* @param string $base_selector The base selector.
* @param array $settings The theme settings.
diff --git a/wp-includes/class-wp-token-map.php b/wp-includes/class-wp-token-map.php
index 317a9830cb..2b463427fb 100644
--- a/wp-includes/class-wp-token-map.php
+++ b/wp-includes/class-wp-token-map.php
@@ -151,6 +151,8 @@ class WP_Token_Map {
* to upgrade pre-computed data from older versions. Choosing a name that
* corresponds to the WordPress release will help people identify where an
* old copy of data came from.
+ *
+ * @since 6.6.0
*/
const STORAGE_VERSION = '6.6.0-trunk';
@@ -643,6 +645,8 @@ class WP_Token_Map {
* ':?' => '😕',
* );
*
+ * @since 6.6.0
+ *
* @return array The lookup key/substitution values as an associate array.
*/
public function to_array(): array {
diff --git a/wp-includes/html-api/class-wp-html-processor.php b/wp-includes/html-api/class-wp-html-processor.php
index 25cc062a35..c278cca8b0 100644
--- a/wp-includes/html-api/class-wp-html-processor.php
+++ b/wp-includes/html-api/class-wp-html-processor.php
@@ -257,6 +257,7 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor {
/**
* Context node if created as a fragment parser.
*
+ * @since 6.6.0
* @var WP_HTML_Token|null
*/
private $context_node = null;
@@ -5133,6 +5134,8 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor {
/**
* Indicates the namespace of the current token, or "html" if there is none.
*
+ * @since 6.7.0
+ *
* @return string One of "html", "math", or "svg".
*/
public function get_namespace(): string {
@@ -6651,6 +6654,7 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor {
* This unlock code is used to ensure that anyone calling the constructor is
* doing so with a full understanding that it's intended to be a private API.
*
+ * @since 6.4.0
* @access private
*/
const CONSTRUCTOR_UNLOCK_CODE = 'Use WP_HTML_Processor::create_fragment() instead of calling the class constructor directly.';
diff --git a/wp-includes/html-api/class-wp-html-tag-processor.php b/wp-includes/html-api/class-wp-html-tag-processor.php
index 0ad4c293a3..7a12fce2d1 100644
--- a/wp-includes/html-api/class-wp-html-tag-processor.php
+++ b/wp-includes/html-api/class-wp-html-tag-processor.php
@@ -689,6 +689,7 @@ class WP_HTML_Tag_Processor {
/**
* Whether the current tag is an opening tag, e.g. <div>, or a closing tag, e.g. </div>.
*
+ * @since 6.2.0
* @var bool
*/
private $is_closing_tag;
@@ -1381,6 +1382,8 @@ class WP_HTML_Tag_Processor {
* Releasing a bookmark frees up the small
* performance overhead it requires.
*
+ * @since 6.2.0
+ *
* @param string $name Name of the bookmark to remove.
* @return bool Whether the bookmark already existed before removal.
*/
@@ -5086,6 +5089,8 @@ class WP_HTML_Tag_Processor {
* This method can be called to perform a full parse of the DOCTYPE token and retrieve
* its information.
*
+ * @since 6.7.0
+ *
* @return WP_HTML_Doctype_Info|null The DOCTYPE declaration information or `null` if not
* currently at a DOCTYPE node.
*/
diff --git a/wp-includes/html-api/class-wp-html-token.php b/wp-includes/html-api/class-wp-html-token.php
index d95f2934c5..de1b843dc3 100644
--- a/wp-includes/html-api/class-wp-html-token.php
+++ b/wp-includes/html-api/class-wp-html-token.php
@@ -81,6 +81,7 @@ class WP_HTML_Token {
/**
* Called when token is garbage-collected or otherwise destroyed.
*
+ * @since 6.4.0
* @var callable|null
*/
public $on_destroy = null;
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-block-directory-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-block-directory-controller.php
index 31267f9600..8bb4116daa 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-block-directory-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-block-directory-controller.php
@@ -18,6 +18,8 @@ class WP_REST_Block_Directory_Controller extends WP_REST_Controller {
/**
* Constructs the controller.
+ *
+ * @since 5.5.0
*/
public function __construct() {
$this->namespace = 'wp/v2';
@@ -26,6 +28,8 @@ class WP_REST_Block_Directory_Controller extends WP_REST_Controller {
/**
* Registers the necessary REST API routes.
+ *
+ * @since 5.5.0
*/
public function register_routes() {
register_rest_route(
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php
index 8846f72788..c7a3ffe327 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php
@@ -2167,6 +2167,8 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
/**
* Check if post type supports notes.
*
+ * @since 6.9.0
+ *
* @param string $post_type Post type name.
* @return bool True if post type supports notes, false otherwise.
*/
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-font-faces-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-font-faces-controller.php
index 6b1d44d440..2aaf63cd10 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-font-faces-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-font-faces-controller.php
@@ -9,6 +9,8 @@
/**
* Class to access font faces through the REST API.
+ *
+ * @since 6.5.0
*/
class WP_REST_Font_Faces_Controller extends WP_REST_Posts_Controller {
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-font-families-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-font-families-controller.php
index a99a885d39..a83f64c816 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-font-families-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-font-families-controller.php
@@ -496,6 +496,8 @@ class WP_REST_Font_Families_Controller extends WP_REST_Posts_Controller {
/**
* Prepares child font face links for the request.
*
+ * @since 6.5.0
+ *
* @param int $font_family_id Font family post ID.
* @return array Links for the child font face posts.
*/
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-global-styles-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-global-styles-controller.php
index 83466acad0..e9f3b281ed 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-global-styles-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-global-styles-controller.php
@@ -9,6 +9,8 @@
/**
* Base Global Styles REST API Controller.
+ *
+ * @since 5.9.0
*/
class WP_REST_Global_Styles_Controller extends WP_REST_Posts_Controller {
/**
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-search-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-search-controller.php
index 1168580d41..4a9c6103d3 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-search-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-search-controller.php
@@ -18,31 +18,43 @@ class WP_REST_Search_Controller extends WP_REST_Controller {
/**
* ID property name.
+ *
+ * @since 5.0.0
*/
const PROP_ID = 'id';
/**
* Title property name.
+ *
+ * @since 5.0.0
*/
const PROP_TITLE = 'title';
/**
* URL property name.
+ *
+ * @since 5.0.0
*/
const PROP_URL = 'url';
/**
* Type property name.
+ *
+ * @since 5.0.0
*/
const PROP_TYPE = 'type';
/**
* Subtype property name.
+ *
+ * @since 5.0.0
*/
const PROP_SUBTYPE = 'subtype';
/**
* Identifier for the 'any' type.
+ *
+ * @since 5.0.0
*/
const TYPE_ANY = 'any';
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php
index 472e8dc12c..dbdb46333f 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php
@@ -19,6 +19,8 @@ class WP_REST_Themes_Controller extends WP_REST_Controller {
/**
* Matches theme's directory: `/themes/<subdirectory>/<theme>/` or `/themes/<theme>/`.
* Excludes invalid directory name characters: `/:<>*?"|`.
+ *
+ * @since 5.9.0
*/
const PATTERN = '[^\/:<>\*\?"\|]+(?:\/[^\/:<>\*\?"\|]+)?';
diff --git a/wp-includes/sitemaps/class-wp-sitemaps-stylesheet.php b/wp-includes/sitemaps/class-wp-sitemaps-stylesheet.php
index 25319b0a0b..b07fe5d4cf 100644
--- a/wp-includes/sitemaps/class-wp-sitemaps-stylesheet.php
+++ b/wp-includes/sitemaps/class-wp-sitemaps-stylesheet.php
@@ -19,6 +19,8 @@ class WP_Sitemaps_Stylesheet {
/**
* Renders the XSL stylesheet depending on whether it's the sitemap index or not.
*
+ * @since 5.5.0
+ *
* @param string $type Stylesheet type. Either 'sitemap' or 'index'.
* @return never
*/
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 052e570afc..a59dfdd6e0 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
*
* @global string $wp_version
*/
-$wp_version = '7.2-alpha-63789';
+$wp_version = '7.2-alpha-63790';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.