Commit 40f935b52e for wordpress.org
commit 40f935b52e5839b009fa1c39df75b35cb3ded2cd
Author: wildworks <wildworks@git.wordpress.org>
Date: Sat Sep 5 09:53:49 2026 +0000
Docs: Align `@param` tag columns in users and multisite docblocks.
Aligns `@param` tag columns in docblocks across the users and multisite code per the PHP inline documentation standards.
Developed in: https://github.com/WordPress/wordpress-develop/pull/13314
Props mukesh27, wildworks.
See #65818.
Built from https://develop.svn.wordpress.org/trunk@63496
git-svn-id: http://core.svn.wordpress.org/trunk@62672 1a063a9b-81f0-0310-95a4-ce76da25c4cd
diff --git a/wp-admin/includes/user.php b/wp-admin/includes/user.php
index 2aeeba0b03..c6c08c4eaf 100644
--- a/wp-admin/includes/user.php
+++ b/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 );
diff --git a/wp-admin/user-edit.php b/wp-admin/user-edit.php
index 5d45c63801..8055de6b36 100644
--- a/wp-admin/user-edit.php
+++ b/wp-admin/user-edit.php
@@ -931,7 +931,7 @@ switch ( $action ) {
*
* @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 );
diff --git a/wp-admin/user-new.php b/wp-admin/user-new.php
index 3136705f60..453a0de54f 100644
--- a/wp-admin/user-new.php
+++ b/wp-admin/user-new.php
@@ -154,7 +154,7 @@ Please click the following link to confirm the invite:
*
* @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.
@@ -162,9 +162,9 @@ Please click the following link to confirm the invite:
* @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 );
diff --git a/wp-includes/class-wp-session-tokens.php b/wp-includes/class-wp-session-tokens.php
index 9482e1b948..03c41ceeb8 100644
--- a/wp-includes/class-wp-session-tokens.php
+++ b/wp-includes/class-wp-session-tokens.php
@@ -154,7 +154,7 @@ abstract class WP_Session_Tokens {
*
* @since 4.0.0
*
- * @param string $token Session token to update.
+ * @param string $token Session token to update.
* @param array $session Session information.
*/
final public function update( $token, $session ) {
diff --git a/wp-includes/ms-functions.php b/wp-includes/ms-functions.php
index 3da25da165..81dda98f3e 100644
--- a/wp-includes/ms-functions.php
+++ b/wp-includes/ms-functions.php
@@ -1851,7 +1851,7 @@ Name: %3$s'
*
* @since 5.6.0
*
- * @param array $new_site_email {
+ * @param array $new_site_email {
* Used to build wp_mail().
*
* @type string $to The email address of the recipient.
@@ -1859,8 +1859,8 @@ Name: %3$s'
* @type string $message The content of the email.
* @type string $headers Headers.
* }
- * @param WP_Site $site Site object of the new site.
- * @param WP_User $user User object of the administrator of the new site.
+ * @param WP_Site $site Site object of the new site.
+ * @param WP_User $user User object of the administrator of the new site.
*/
$new_site_email = apply_filters( 'new_site_email', $new_site_email, $site, $user );
@@ -2940,7 +2940,7 @@ All at ###SITENAME###
*
* @since 4.9.0
*
- * @param array $email_change_email {
+ * @param array $email_change_email {
* Used to build wp_mail().
*
* @type string $to The intended recipient.
@@ -2953,9 +2953,9 @@ All at ###SITENAME###
* - `###SITEURL###` The URL to the site.
* @type string $headers Headers.
* }
- * @param string $old_email The old network admin email address.
- * @param string $new_email The new network admin email address.
- * @param int $network_id ID of the network.
+ * @param string $old_email The old network admin email address.
+ * @param string $new_email The new network admin email address.
+ * @param int $network_id ID of the network.
*/
$email_change_email = apply_filters( 'network_admin_email_change_email', $email_change_email, $old_email, $new_email, $network_id );
diff --git a/wp-includes/sitemaps/providers/class-wp-sitemaps-users.php b/wp-includes/sitemaps/providers/class-wp-sitemaps-users.php
index 8e9f57dc6c..a2ce30a4eb 100644
--- a/wp-includes/sitemaps/providers/class-wp-sitemaps-users.php
+++ b/wp-includes/sitemaps/providers/class-wp-sitemaps-users.php
@@ -46,7 +46,7 @@ class WP_Sitemaps_Users extends WP_Sitemaps_Provider {
* @since 5.5.0
*
* @param array[]|null $url_list The URL list. Default null.
- * @param int $page_num Page of results.
+ * @param int $page_num Page of results.
*/
$url_list = apply_filters(
'wp_sitemaps_users_pre_url_list',
diff --git a/wp-includes/user.php b/wp-includes/user.php
index 3e8d76b1e4..6ce8dbf051 100644
--- a/wp-includes/user.php
+++ b/wp-includes/user.php
@@ -2598,7 +2598,7 @@ function wp_insert_user( $userdata ) {
* @since 4.4.0
* @since 5.8.0 The `$userdata` parameter was added.
*
- * @param array $meta {
+ * @param array $meta {
* Default meta values and keys for the user.
*
* @type string $nickname The user's nickname. Default is the user's username.
@@ -3461,7 +3461,7 @@ function retrieve_password( $user_login = '' ) {
*
* @since 6.0.0
*
- * @param array $defaults {
+ * @param array $defaults {
* The default notification email arguments. Used to build wp_mail().
*
* @type string $to The intended recipient - user email address.
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 24b8f91db9..658d05b1b9 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
*
* @global string $wp_version
*/
-$wp_version = '7.2-alpha-63495';
+$wp_version = '7.2-alpha-63496';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.