Commit 273abae608 for wordpress.org
commit 273abae608d3979249170095d13c00d3b2b11bf8
Author: wildworks <wildworks@git.wordpress.org>
Date: Sat Sep 5 08:58:50 2026 +0000
Docs: Align `@param` tag columns in REST API docblocks.
Aligns `@param` tag columns in docblocks across the REST API per the PHP inline documentation standards.
Developed in: https://github.com/WordPress/wordpress-develop/pull/13312
Props mukesh27, wildworks.
See #65818.
Built from https://develop.svn.wordpress.org/trunk@63493
git-svn-id: http://core.svn.wordpress.org/trunk@62669 1a063a9b-81f0-0310-95a4-ce76da25c4cd
diff --git a/wp-includes/rest-api.php b/wp-includes/rest-api.php
index 892716b5d6..af81ea640b 100644
--- a/wp-includes/rest-api.php
+++ b/wp-includes/rest-api.php
@@ -1885,7 +1885,7 @@ function rest_find_matching_pattern_property_schema( $property, $args ) {
* @since 5.6.0
*
* @param string $param The parameter name.
- * @param array $error The error details.
+ * @param array $error The error details.
* @return WP_Error
*/
function rest_format_combining_operation_error( $param, $error ) {
diff --git a/wp-includes/rest-api/class-wp-rest-server.php b/wp-includes/rest-api/class-wp-rest-server.php
index c7ffb5b767..7a40bd9b20 100644
--- a/wp-includes/rest-api/class-wp-rest-server.php
+++ b/wp-includes/rest-api/class-wp-rest-server.php
@@ -259,7 +259,7 @@ class WP_REST_Server {
*
* @since 6.1.0
*
- * @param int $options JSON encoding options {@see json_encode()}.
+ * @param int $options JSON encoding options {@see json_encode()}.
* @param WP_REST_Request $request Current request object.
*/
return apply_filters( 'rest_json_encode_options', $options, $request );
@@ -1914,7 +1914,7 @@ class WP_REST_Server {
*
* @since 4.4.0
*
- * @param string $key Header key.
+ * @param string $key Header key.
* @param string $value Header value.
*/
public function send_header( $key, $value ) {
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-abilities-v1-categories-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-abilities-v1-categories-controller.php
index abbce844ef..7b0235cb8b 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-abilities-v1-categories-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-abilities-v1-categories-controller.php
@@ -185,7 +185,7 @@ class WP_REST_Abilities_V1_Categories_Controller extends WP_REST_Controller {
* @since 6.9.0
*
* @param WP_Ability_Category $category The ability category object.
- * @param WP_REST_Request $request Request object.
+ * @param WP_REST_Request $request Request object.
* @return WP_REST_Response Response object.
*/
public function prepare_item_for_response( $category, $request ) {
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 d14aefb1f6..dfe4946595 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
@@ -523,10 +523,10 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
*
* @since 4.7.0
*
- * @param bool $allow_anonymous Whether to allow anonymous comments to
- * be created. Default `false`.
- * @param WP_REST_Request $request Request used to generate the
- * response.
+ * @param bool $allow_anonymous Whether to allow anonymous comments to
+ * be created. Default `false`.
+ * @param WP_REST_Request $request Request used to generate the
+ * response.
*/
$allow_anonymous = apply_filters( 'rest_allow_anonymous_comments', false, $request );
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php
index 396d657fd2..919714c5a9 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php
@@ -322,9 +322,9 @@ class WP_REST_Menu_Items_Controller extends WP_REST_Posts_Controller {
*
* @since 5.9.0
*
- * @param object $nav_menu_item Inserted or updated menu item object.
- * @param WP_REST_Response $response The response data.
- * @param WP_REST_Request $request Request object.
+ * @param object $nav_menu_item Inserted or updated menu item object.
+ * @param WP_REST_Response $response The response data.
+ * @param WP_REST_Request $request Request object.
*/
do_action( 'rest_delete_nav_menu_item', $menu_item, $response, $request );
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php
index 0121298105..2dbba2b6d5 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php
@@ -527,10 +527,10 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
*
* @since 4.7.0
*
- * @param WP_Post|false|null $result The revision object (if it was deleted or moved to the Trash successfully)
- * or false or null (failure). If the revision was moved to the Trash, $result represents
- * its new state; if it was deleted, $result represents its state before deletion.
- * @param WP_REST_Request $request The request sent to the API.
+ * @param WP_Post|false|null $result The revision object (if it was deleted or moved to the Trash successfully)
+ * or false or null (failure). If the revision was moved to the Trash, $result represents
+ * its new state; if it was deleted, $result represents its state before deletion.
+ * @param WP_REST_Request $request The request sent to the API.
*/
do_action( 'rest_delete_revision', $result, $request );
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-widget-types-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-widget-types-controller.php
index a36fe356e9..cd90518851 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-widget-types-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-widget-types-controller.php
@@ -572,7 +572,7 @@ class WP_REST_Widget_Types_Controller extends WP_REST_Controller {
* @since 5.8.0
*
* @param WP_Widget $widget_object Widget object to call widget() on.
- * @param array $instance Widget instance settings.
+ * @param array $instance Widget instance settings.
* @return string
*/
private function get_widget_form( $widget_object, $instance ) {
@@ -620,7 +620,7 @@ class WP_REST_Widget_Types_Controller extends WP_REST_Controller {
*
* @since 5.9.0
*
- * @param string $id_base The id base of the requested widget.
+ * @param string $id_base The id base of the requested widget.
* @param array $instance The widget instance attributes.
* @return string Rendered Legacy Widget block preview.
*/
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 1be54cd33b..6905c3e428 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
*
* @global string $wp_version
*/
-$wp_version = '7.2-alpha-63492';
+$wp_version = '7.2-alpha-63493';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.