Docs: Align @param tag columns in docblocks.

src/wp-admin/comment.php

@@ -372,8 +372,8 @@
 		 *
 		 * @since 2.1.0
 		 *
-		 * @param string $location The URI the user will be redirected to.
-		 * @param int $comment_id The ID of the comment being edited.
+		 * @param string $location   The URI the user will be redirected to.
+		 * @param int    $comment_id The ID of the comment being edited.
 		 */
 		$location = apply_filters( 'comment_edit_redirect', $location, $comment_id );
 

src/wp-admin/includes/class-wp-automatic-updater.php

@@ -170,10 +170,10 @@ public function is_vcs_checkout( $context ) {
 		 *
 		 * @since 3.7.0
 		 *
-		 * @param bool $checkout  Whether a VCS checkout was discovered at `$context`
-		 *                        or ABSPATH, or anywhere higher.
-		 * @param string $context The filesystem context (a path) against which
-		 *                        filesystem status should be checked.
+		 * @param bool   $checkout Whether a VCS checkout was discovered at `$context`
+		 *                         or ABSPATH, or anywhere higher.
+		 * @param string $context  The filesystem context (a path) against which
+		 *                         filesystem status should be checked.
 		 */
 		return apply_filters( 'automatic_updates_is_vcs_checkout', $checkout, $context );
 	}
@@ -1130,7 +1130,7 @@ protected function send_email( $type, $core_update, $result = null ) {
 		 *
 		 * @since 3.7.0
 		 *
-		 * @param array $email {
+		 * @param array  $email {
 		 *     Array of email arguments that will be passed to wp_mail().
 		 *
 		 *     @type string $to      The email recipient. An array of emails

src/wp-admin/includes/class-wp-community-events.php

@@ -39,7 +39,7 @@ class WP_Community_Events {
 	 *
 	 * @since 4.8.0
 	 *
-	 * @param int        $user_id       WP user ID.
+	 * @param int         $user_id       WP user ID.
 	 * @param false|array $user_location {
 	 *     Stored location data for the user. false to pass no location.
 	 *

src/wp-admin/includes/class-wp-internal-pointers.php

@@ -109,8 +109,8 @@ public static function enqueue_scripts( $hook_suffix ) {
 	 * @since 3.3.0
 	 *
 	 * @param string $pointer_id The pointer ID.
-	 * @param string $selector The HTML elements, on which the pointer should be attached.
-	 * @param array  $args Arguments to be passed to the pointer JS (see wp-pointer.js).
+	 * @param string $selector   The HTML elements, on which the pointer should be attached.
+	 * @param array  $args       Arguments to be passed to the pointer JS (see wp-pointer.js).
 	 */
 	private static function print_js( $pointer_id, $selector, $args ) {
 		if ( empty( $pointer_id ) || empty( $selector ) || empty( $args ) || empty( $args['content'] ) ) {

src/wp-admin/includes/class-wp-list-table.php

@@ -729,7 +729,7 @@ protected function months_dropdown( $post_type ) {
 		 *
 		 * @since 5.7.0
 		 *
-		 * @param object[]|false $months   'Months' drop-down results. Default false.
+		 * @param object[]|false $months    'Months' drop-down results. Default false.
 		 * @param string         $post_type The post type.
 		 */
 		$months = apply_filters( 'pre_months_dropdown_query', false, $post_type );

src/wp-admin/includes/class-wp-posts-list-table.php

@@ -1854,7 +1854,7 @@ public function inline_edit() {
 							 * @see wp_dropdown_users()
 							 *
 							 * @param array $users_opt An array of arguments passed to wp_dropdown_users().
-							 * @param bool $bulk A flag to denote if it's a bulk action.
+							 * @param bool  $bulk      A flag to denote if it's a bulk action.
 							 */
 							$users_opt = apply_filters( 'quick_edit_dropdown_authors_args', $users_opt, $bulk );
 

src/wp-admin/includes/class-wp-site-health-auto-updates.php

@@ -63,9 +63,9 @@ static function ( $test ) {
 	 * @since 5.2.0
 	 * @since 5.5.1 The `$value` parameter can accept an array.
 	 *
-	 * @param string $constant         The name of the constant to check.
-	 * @param bool|string|array $value The value that the constant should be, if set,
-	 *                                 or an array of acceptable values.
+	 * @param string            $constant The name of the constant to check.
+	 * @param bool|string|array $value    The value that the constant should be, if set,
+	 *                                    or an array of acceptable values.
 	 * @return array|null The test results if there are any constants set incorrectly,
 	 *                    or null if the test passed.
 	 */

src/wp-admin/includes/class-wp-terms-list-table.php

@@ -395,8 +395,8 @@ public function column_name( $tag ) {
 		 *
 		 * @see WP_Terms_List_Table::column_name()
 		 *
-		 * @param string $pad_tag_name The term name, padded if not top-level.
-		 * @param WP_Term $tag         Term object.
+		 * @param string  $pad_tag_name The term name, padded if not top-level.
+		 * @param WP_Term $tag          Term object.
 		 */
 		$name = apply_filters( 'term_name', $pad . ' ' . $tag->name, $tag );
 

src/wp-admin/includes/file.php

@@ -1311,7 +1311,7 @@ function download_url( $url, $timeout = 300, $signature_verification = false ) {
 			 * @since 5.2.0
 			 *
 			 * @param false|string $signature_url The URL where signatures can be found for a file, or false if none are known.
-			 * @param string $url                 The URL being verified.
+			 * @param string       $url           The URL being verified.
 			 */
 			$signature_url = apply_filters( 'wp_signature_url', $signature_url, $url );
 

src/wp-admin/includes/list-table.php

@@ -84,7 +84,7 @@ function _get_list_table( $class_name, $args = array() ) {
  *
  * @since 2.7.0
  *
- * @param string    $screen The handle for the screen to register column headers for. This is
+ * @param string   $screen  The handle for the screen to register column headers for. This is
  *                          usually the hook name returned by the `add_*_page()` functions.
  * @param string[] $columns An array of columns with column IDs as the keys and translated
  *                          column names as the values.

src/wp-admin/includes/media.php

@@ -3549,7 +3549,7 @@ function attachment_submitbox_metadata() {
  * @since 3.6.0
  *
  * @param array $metadata An existing array with data.
- * @param array $data Data supplied by ID3 tags.
+ * @param array $data     Data supplied by ID3 tags.
  */
 function wp_add_id3_tag_data( &$metadata, $data ) {
 	foreach ( array( 'id3v2', 'id3v1' ) as $version ) {

src/wp-admin/includes/plugin-install.php

@@ -895,15 +895,15 @@ function install_plugin_information() {
  * @since 6.5.0
  *
  * @param string       $name           Plugin name.
- * @param array|object $data           {
+ * @param array|object $data {
  *     An array or object of plugin data. Can be retrieved from the API.
  *
  *     @type string   $slug             The plugin slug.
  *     @type string[] $requires_plugins An array of plugin dependency slugs.
  *     @type string   $version          The plugin's version string. Used when getting the install status.
  * }
- * @param bool         $compatible_php   The result of a PHP compatibility check.
- * @param bool         $compatible_wp    The result of a WP compatibility check.
+ * @param bool         $compatible_php The result of a PHP compatibility check.
+ * @param bool         $compatible_wp  The result of a WP compatibility check.
  * @return string The markup for the dependency row button. An empty string if the user does not have capabilities.
  */
 function wp_get_plugin_action_button( $name, $data, $compatible_php, $compatible_wp ) {

src/wp-admin/includes/plugin.php

@@ -1264,7 +1264,7 @@ function validate_plugin_requirements( $plugin ) {
 	 * @since 6.9.0
 	 *
 	 * @param bool|WP_Error $met_requirements True if the plugin meets requirements, WP_Error if not.
-	 * @param string $plugin Path to the plugin file relative to the plugins directory.
+	 * @param string        $plugin           Path to the plugin file relative to the plugins directory.
 	 */
 	return apply_filters( 'validate_plugin_requirements', true, $plugin );
 }

src/wp-admin/includes/post.php

@@ -2607,7 +2607,7 @@ function the_block_editor_meta_box_post_form_hidden_fields( $post ) {
  * @since 5.9.0
  * @access private
  *
- * @param bool   $value Whether the CPT supports block editor or not.
+ * @param bool   $value     Whether the CPT supports block editor or not.
  * @param string $post_type Post type.
  * @return bool Whether the block editor should be disabled or not.
  */

src/wp-admin/includes/template.php

@@ -1808,7 +1808,7 @@ function do_settings_sections( $page ) {
  *
  * @global array $wp_settings_fields Storage array of settings fields and their pages/sections.
  *
- * @param string $page Slug title of the admin page whose settings fields you want to show.
+ * @param string $page    Slug title of the admin page whose settings fields you want to show.
  * @param string $section Slug title of the settings section whose fields you want to show.
  */
 function do_settings_fields( $page, $section ) {

src/wp-admin/includes/theme.php

@@ -157,7 +157,7 @@ function get_page_templates( $post = null, $post_type = 'page' ) {
  * @since 2.9.0
  * @access private
  *
- * @param string $fullpath Full path to the theme file
+ * @param string $fullpath         Full path to the theme file
  * @param string $containingfolder Path of the theme parent folder
  * @return string
  */

src/wp-admin/includes/upgrade.php

@@ -621,19 +621,19 @@ function wp_new_blog_notification(
 		 *
 		 * @since 5.6.0
 		 *
-		 * @param array $installed_email {
+		 * @param array   $installed_email {
 		 *     Used to build wp_mail().
 		 *
 		 *     @type string $to      The email address of the recipient.
 		 *     @type string $subject The subject of the email.
 		 *     @type string $message The content of the email.
 		 *     @type string $headers Headers.
 		 * }
-		 * @param WP_User $user          The site administrator user object.
-		 * @param string  $blog_title    The site title.
-		 * @param string  $blog_url      The site URL.
-		 * @param string  $password      The site administrator's password. Note that a placeholder message
-		 *                               is usually passed instead of the user's actual password.
+		 * @param WP_User $user            The site administrator user object.
+		 * @param string  $blog_title      The site title.
+		 * @param string  $blog_url        The site URL.
+		 * @param string  $password        The site administrator's password. Note that a placeholder message
+		 *                                 is usually passed instead of the user's actual password.
 		 */
 		$installed_email = apply_filters( 'wp_installed_email', $installed_email, $user, $blog_title, $blog_url, $password );
 

src/wp-admin/includes/user.php

@@ -169,8 +169,8 @@ function edit_user( $user_id = 0 ) {
 	 * @since 1.5.1
 	 *
 	 * @param string $user_login The username.
-	 * @param string $pass1     The password (passed by reference).
-	 * @param string $pass2     The confirmed password (passed by reference).
+	 * @param string $pass1      The password (passed by reference).
+	 * @param string $pass2      The confirmed password (passed by reference).
 	 */
 	do_action_ref_array( 'check_passwords', array( $user->user_login, &$pass1, &$pass2 ) );
 
@@ -717,7 +717,7 @@ function wp_is_authorize_application_redirect_url_valid( $url ) {
 	 * @since 6.3.2
 	 *
 	 * @param string[] $bad_protocols Array of invalid protocols.
-	 * @param string   $url The redirect URL to be validated.
+	 * @param string   $url           The redirect URL to be validated.
 	 */
 	$invalid_protocols = apply_filters( 'wp_authorize_application_redirect_url_invalid_protocols', $bad_protocols, $url );
 	$invalid_protocols = array_map( 'strtolower', $invalid_protocols );

src/wp-admin/user-edit.php

@@ -931,7 +931,7 @@
 					 *
 					 * @since 2.8.0
 					 *
-					 * @param bool    $enable      Whether to display the capabilities. Default true.
+					 * @param bool    $enable       Whether to display the capabilities. Default true.
 					 * @param WP_User $profile_user The current WP_User object.
 					 */
 					$display_additional_caps = apply_filters( 'additional_capabilities_display', true, $profile_user );

src/wp-admin/user-new.php

@@ -154,17 +154,17 @@
 			 *
 			 * @since 5.6.0
 			 *
-			 * @param array $new_user_email {
+			 * @param array  $new_user_email {
 			 *     Used to build wp_mail().
 			 *
 			 *     @type string $to      The email address of the invited user.
 			 *     @type string $subject The subject of the email.
 			 *     @type string $message The content of the email.
 			 *     @type string $headers Headers.
 			 * }
-			 * @param int    $user_id     The invited user's ID.
-			 * @param array  $role        Array containing role information for the invited user.
-			 * @param string $newuser_key The key of the invitation.
+			 * @param int    $user_id        The invited user's ID.
+			 * @param array  $role           Array containing role information for the invited user.
+			 * @param string $newuser_key    The key of the invitation.
 			 *
 			 */
 			$new_user_email = apply_filters( 'invited_user_email', $new_user_email, $user_id, $role, $newuser_key );

src/wp-admin/widgets-form-blocks.php

@@ -121,7 +121,7 @@
 		 *
 		 * @since 6.4.0
 		 *
-		 * @param string $message The message being displayed.
+		 * @param string $message   The message being displayed.
 		 * @param bool   $installed Whether the Classic Widget plugin is installed.
 		 */
 		$message = apply_filters( 'block_widgets_no_javascript_message', $message, $installed );

src/wp-content/themes/twentyfourteen/functions.php

@@ -680,7 +680,7 @@ function twentyfourteen_post_classes( $classes ) {
  * @global int $page  Page number of a single post.
  *
  * @param string $title Default title text for current view.
- * @param string $sep Optional separator.
+ * @param string $sep   Optional separator.
  * @return string The filtered title.
  */
 function twentyfourteen_wp_title( $title, $sep ) {

src/wp-content/themes/twentytwelve/functions.php

@@ -309,7 +309,7 @@ function twentytwelve_mce_css( $mce_css ) {
  * @global int $page  Page number of a single post.
  *
  * @param string $title Default title text for current view.
- * @param string $sep Optional separator.
+ * @param string $sep   Optional separator.
  * @return string Filtered title.
  */
 function twentytwelve_wp_title( $title, $sep ) {

src/wp-includes/block-supports/layout.php

@@ -1530,7 +1530,7 @@ static function ( $matches ) {
  * @access private
  *
  * @param string $block_content Rendered block content.
- * @param  array  $block        Block object.
+ * @param array  $block         Block object.
  * @return string Filtered block content.
  */
 function wp_restore_image_outer_container( $block_content, $block ) {

src/wp-includes/block-supports/settings.php

@@ -69,8 +69,8 @@ function _wp_add_block_level_presets_class( $block_content, $block ) {
  * @since 6.3.0 Updated preset styles to use Selectors API.
  * @access private
  *
- * @param string|null $pre_render   The pre-rendered content. Default null.
- * @param array       $block The block being rendered.
+ * @param string|null $pre_render The pre-rendered content. Default null.
+ * @param array       $block      The block being rendered.
  * @return null
  */
 function _wp_add_block_level_preset_styles( $pre_render, $block ) {

src/wp-includes/block-template-utils.php

@@ -1114,15 +1114,15 @@ function get_block_templates( $query = array(), $template_type = 'wp_template' )
 	 *
 	 * @param WP_Block_Template[]|null $block_templates Return an array of block templates to short-circuit the default query,
 	 *                                                  or null to allow WP to run its normal queries.
-	 * @param array  $query {
+	 * @param array                    $query {
 	 *     Arguments to retrieve templates. All arguments are optional.
 	 *
 	 *     @type string[] $slug__in  List of slugs to include.
 	 *     @type int      $wp_id     Post ID of customized template.
 	 *     @type string   $area      A 'wp_template_part_area' taxonomy value to filter by (for 'wp_template_part' template type only).
 	 *     @type string   $post_type Post type to get the templates for.
 	 * }
-	 * @param string $template_type Template type. Either 'wp_template' or 'wp_template_part'.
+	 * @param string                   $template_type   Template type. Either 'wp_template' or 'wp_template_part'.
 	 */
 	$templates = apply_filters( 'pre_get_block_templates', null, $query, $template_type );
 	if ( ! is_null( $templates ) ) {
@@ -1263,7 +1263,7 @@ function ( $template ) {
 	 *
 	 * @since 5.9.0
 	 *
-	 * @param WP_Block_Template[] $query_result Array of found block templates.
+	 * @param WP_Block_Template[] $query_result  Array of found block templates.
 	 * @param array               $query {
 	 *     Arguments to retrieve templates. All arguments are optional.
 	 *

src/wp-includes/blocks.php

@@ -1258,13 +1258,13 @@ function apply_block_hooks_to_content( $content, $context = null, $callback = 'i
  * @since 7.0.0 Added the `$ignored_hooked_blocks_at_root` parameter.
  * @access private
  *
- * @param string       $content  Serialized content.
- * @param WP_Post|null $post     A post object that the content belongs to. If set to `null`,
- *                               `get_post()` will be called to use the current post as context.
- *                               Default: `null`.
- * @param callable     $callback A function that will be called for each block to generate
- *                               the markup for a given list of blocks that are hooked to it.
- *                               Default: 'insert_hooked_blocks'.
+ * @param string       $content                       Serialized content.
+ * @param WP_Post|null $post                          A post object that the content belongs to. If set to `null`,
+ *                                                    `get_post()` will be called to use the current post as context.
+ *                                                    Default: `null`.
+ * @param callable     $callback                      A function that will be called for each block to generate
+ *                                                    the markup for a given list of blocks that are hooked to it.
+ *                                                    Default: 'insert_hooked_blocks'.
  * @param array|null   $ignored_hooked_blocks_at_root A reference to an array that will be populated
  *                               with the ignored hooked blocks at the root level.
  *                               Default: `null`.

src/wp-includes/blocks/accordion.php

@@ -5,8 +5,8 @@
  * @package WordPress
  * @since 6.9.0
  *
- * @param array $attributes The block attributes.
- * @param string $content The block content.
+ * @param array  $attributes The block attributes.
+ * @param string $content    The block content.
  *
  * @return string Returns the updated markup.
  */

src/wp-includes/blocks/heading.php

@@ -17,7 +17,7 @@
  * @since 6.2.0
  *
  * @param array  $attributes Attributes of the block being rendered.
- * @param string $content Content of the block being rendered.
+ * @param string $content    Content of the block being rendered.
  *
  * @return string The content of the block being rendered.
  */

src/wp-includes/blocks/list.php

@@ -15,7 +15,7 @@
  * @see https://github.com/WordPress/gutenberg/issues/12420
  *
  * @param array  $attributes Attributes of the block being rendered.
- * @param string $content Content of the block being rendered.
+ * @param string $content    Content of the block being rendered.
  *
  * @return string The content of the block being rendered.
  */

src/wp-includes/blocks/navigation-link.php

@@ -304,7 +304,7 @@ function render_block_core_navigation_link( $attributes, $content, $block ) {
  * @since 5.9.0
  *
  * @param WP_Taxonomy|WP_Post_Type $entity post type or taxonomy entity.
- * @param string                   $kind string of value 'taxonomy' or 'post-type'.
+ * @param string                   $kind   string of value 'taxonomy' or 'post-type'.
  *
  * @return array
  */