Docs: Remove an empty line between `@param` and `@return` tags in some newly added REST API methods, per the documentation standards.

Follow-up to [48242], [49925], [51003], [51021].

See #52628, #53461.
Built from https://develop.svn.wordpress.org/trunk@51289


git-svn-id: http://core.svn.wordpress.org/trunk@50898 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-includes/rest-api/class-wp-rest-server.php

@@ -1080,7 +1080,6 @@ class WP_REST_Server {
 	 * @param array           $handler  The matched route handler.
 	 * @param string          $route    The matched route regex.
 	 * @param WP_Error|null   $response The current error object if any.
-	 *
 	 * @return WP_REST_Response
 	 */
 	protected function respond_to_request( $request, $route, $handler, $response ) {

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

@@ -49,7 +49,6 @@ class WP_REST_Block_Directory_Controller extends WP_REST_Controller {
 	 * @since 5.5.0
 	 *
 	 * @param WP_REST_Request $request Full details about the request.
-	 *
 	 * @return true|WP_Error True if the request has permission, WP_Error object otherwise.
 	 */
 	public function get_items_permissions_check( $request ) {
@@ -70,7 +69,6 @@ class WP_REST_Block_Directory_Controller extends WP_REST_Controller {
 	 * @since 5.5.0
 	 *
 	 * @param WP_REST_Request $request Full details about the request.
-	 *
 	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
 	 */
 	public function get_items( $request ) {
@@ -114,7 +112,6 @@ class WP_REST_Block_Directory_Controller extends WP_REST_Controller {
 	 *
 	 * @param array           $plugin  The plugin metadata.
 	 * @param WP_REST_Request $request Request object.
-	 *
 	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
 	 */
 	public function prepare_item_for_response( $plugin, $request ) {
@@ -156,7 +153,6 @@ class WP_REST_Block_Directory_Controller extends WP_REST_Controller {
 	 * @since 5.5.0
 	 *
 	 * @param array $plugin The plugin data from WordPress.org.
-	 *
 	 * @return array
 	 */
 	protected function prepare_links( $plugin ) {
@@ -184,7 +180,6 @@ class WP_REST_Block_Directory_Controller extends WP_REST_Controller {
 	 * @since 5.5.0
 	 *
 	 * @param string $slug The WordPress.org directory slug for a plugin.
-	 *
 	 * @return string The plugin file found matching it.
 	 */
 	protected function find_plugin_for_slug( $slug ) {

wp-includes/rest-api/endpoints/class-wp-rest-pattern-directory-controller.php

@@ -56,7 +56,6 @@ class WP_REST_Pattern_Directory_Controller extends WP_REST_Controller {
 	 * @since 5.8.0
 	 *
 	 * @param WP_REST_Request $request Full details about the request.
-	 *
 	 * @return true|WP_Error True if the request has permission, WP_Error object otherwise.
 	 */
 	public function get_items_permissions_check( $request ) {
@@ -83,7 +82,6 @@ class WP_REST_Pattern_Directory_Controller extends WP_REST_Controller {
 	 * @since 5.8.0
 	 *
 	 * @param WP_REST_Request $request Full details about the request.
-	 *
 	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
 	 */
 	public function get_items( $request ) {
@@ -204,7 +202,6 @@ class WP_REST_Pattern_Directory_Controller extends WP_REST_Controller {
 	 *
 	 * @param object          $raw_pattern A pattern from api.wordpress.org, before any changes.
 	 * @param WP_REST_Request $request     Request object.
-	 *
 	 * @return WP_REST_Response
 	 */
 	public function prepare_item_for_response( $raw_pattern, $request ) {

wp-includes/rest-api/endpoints/class-wp-rest-plugins-controller.php

@@ -679,7 +679,6 @@ class WP_REST_Plugins_Controller extends WP_REST_Controller {
 	 * @param string $plugin         The plugin file to update.
 	 * @param string $new_status     The plugin's new status.
 	 * @param string $current_status The plugin's current status.
-	 *
 	 * @return true|WP_Error
 	 */
 	protected function plugin_status_permission_check( $plugin, $new_status, $current_status ) {
@@ -789,7 +788,6 @@ class WP_REST_Plugins_Controller extends WP_REST_Controller {
 	 *
 	 * @param WP_REST_Request $request The request to require the plugin matches against.
 	 * @param array           $item    The plugin item.
-	 *
 	 * @return bool
 	 */
 	protected function does_plugin_match_request( $request, $item ) {

wp-includes/rest-api/endpoints/class-wp-rest-sidebars-controller.php

@@ -268,7 +268,6 @@ class WP_REST_Sidebars_Controller extends WP_REST_Controller {
 	 *
 	 * @param array           $raw_sidebar Sidebar instance.
 	 * @param WP_REST_Request $request     Full details about the request.
-	 *
 	 * @return WP_REST_Response Prepared response object.
 	 */
 	public function prepare_item_for_response( $raw_sidebar, $request ) {
@@ -344,7 +343,6 @@ class WP_REST_Sidebars_Controller extends WP_REST_Controller {
 	 * @since 5.8.0
 	 *
 	 * @param array $sidebar Sidebar.
-	 *
 	 * @return array Links for the given widget.
 	 */
 	protected function prepare_links( $sidebar ) {

wp-includes/rest-api/endpoints/class-wp-rest-templates-controller.php

@@ -145,7 +145,6 @@ class WP_REST_Templates_Controller extends WP_REST_Controller {
 	 * @since 5.8.0
 	 *
 	 * @param WP_REST_Request $request The request instance.
-	 *
 	 * @return WP_REST_Response
 	 */
 	public function get_items( $request ) {
@@ -156,6 +155,7 @@ class WP_REST_Templates_Controller extends WP_REST_Controller {
 		if ( isset( $request['area'] ) ) {
 			$query['area'] = $request['area'];
 		}
+
 		$templates = array();
 		foreach ( get_block_templates( $query, $this->post_type ) as $template ) {
 			$data        = $this->prepare_item_for_response( $template, $request );
@@ -183,7 +183,6 @@ class WP_REST_Templates_Controller extends WP_REST_Controller {
 	 * @since 5.8.0
 	 *
 	 * @param WP_REST_Request $request The request instance.
-	 *
 	 * @return WP_REST_Response|WP_Error
 	 */
 	public function get_item( $request ) {
@@ -405,7 +404,6 @@ class WP_REST_Templates_Controller extends WP_REST_Controller {
 	 *
 	 * @param WP_Block_Template $template Template instance.
 	 * @param WP_REST_Request   $request Request object.
-	 *
 	 * @return WP_REST_Response $data
 	 */
 	public function prepare_item_for_response( $template, $request ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable

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

@@ -349,7 +349,6 @@ class WP_REST_Themes_Controller extends WP_REST_Controller {
 	 *
 	 * @param WP_Theme $theme_a First theme to compare.
 	 * @param WP_Theme $theme_b Second theme to compare.
-	 *
 	 * @return bool
 	 */
 	protected function is_same_theme( $theme_a, $theme_b ) {

wp-includes/rest-api/endpoints/class-wp-rest-widgets-controller.php

@@ -424,7 +424,6 @@ class WP_REST_Widgets_Controller extends WP_REST_Controller {
 	 *
 	 * @param WP_REST_Request $request    Full details about the request.
 	 * @param string          $sidebar_id ID of the sidebar the widget belongs to.
-	 *
 	 * @return string|WP_Error The saved widget ID.
 	 */
 	protected function save_widget( $request, $sidebar_id ) {

wp-includes/version.php

@@ -13,7 +13,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '5.9-alpha-51288';
+$wp_version = '5.9-alpha-51289';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.