Commit 7f59192864 for wordpress.org
commit 7f59192864c156d95175d1d66e07f5161d7ff264
Author: wildworks <wildworks@git.wordpress.org>
Date: Sat Sep 5 09:27:48 2026 +0000
Docs: Align `@param` tag columns in upgrade, plugin, and theme docblocks.
Aligns `@param` tag columns in docblocks across the upgrade, plugin, and theme code per the PHP inline documentation standards.
Developed in: https://github.com/WordPress/wordpress-develop/pull/13313
Props mukesh27, wildworks.
See #65818.
Built from https://develop.svn.wordpress.org/trunk@63494
git-svn-id: http://core.svn.wordpress.org/trunk@62670 1a063a9b-81f0-0310-95a4-ce76da25c4cd
diff --git a/wp-admin/includes/class-wp-automatic-updater.php b/wp-admin/includes/class-wp-automatic-updater.php
index cd9426c6ef..aa4db87eff 100644
--- a/wp-admin/includes/class-wp-automatic-updater.php
+++ b/wp-admin/includes/class-wp-automatic-updater.php
@@ -170,10 +170,10 @@ class WP_Automatic_Updater {
*
* @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 @@ class WP_Automatic_Updater {
*
* @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
diff --git a/wp-admin/includes/class-wp-site-health-auto-updates.php b/wp-admin/includes/class-wp-site-health-auto-updates.php
index 1904acd4e0..3c0c8b3844 100644
--- a/wp-admin/includes/class-wp-site-health-auto-updates.php
+++ b/wp-admin/includes/class-wp-site-health-auto-updates.php
@@ -63,9 +63,9 @@ class WP_Site_Health_Auto_Updates {
* @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.
*/
diff --git a/wp-admin/includes/plugin-install.php b/wp-admin/includes/plugin-install.php
index dc232f1df7..62e93a36ee 100644
--- a/wp-admin/includes/plugin-install.php
+++ b/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 ) {
diff --git a/wp-admin/includes/plugin.php b/wp-admin/includes/plugin.php
index 94d4a585a8..9969316ab8 100644
--- a/wp-admin/includes/plugin.php
+++ b/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 );
}
diff --git a/wp-admin/includes/theme.php b/wp-admin/includes/theme.php
index ef5793b7dd..5ee488536e 100644
--- a/wp-admin/includes/theme.php
+++ b/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
*/
diff --git a/wp-admin/includes/upgrade.php b/wp-admin/includes/upgrade.php
index 37e15696d4..244401cf24 100644
--- a/wp-admin/includes/upgrade.php
+++ b/wp-admin/includes/upgrade.php
@@ -621,7 +621,7 @@ https://wordpress.org/
*
* @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.
@@ -629,11 +629,11 @@ https://wordpress.org/
* @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 );
diff --git a/wp-content/themes/twentyfourteen/functions.php b/wp-content/themes/twentyfourteen/functions.php
index 77e5935f11..6771117ab3 100644
--- a/wp-content/themes/twentyfourteen/functions.php
+++ b/wp-content/themes/twentyfourteen/functions.php
@@ -680,7 +680,7 @@ add_filter( 'post_class', 'twentyfourteen_post_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 ) {
diff --git a/wp-content/themes/twentytwelve/functions.php b/wp-content/themes/twentytwelve/functions.php
index 877da5a297..a6c3300bb4 100644
--- a/wp-content/themes/twentytwelve/functions.php
+++ b/wp-content/themes/twentytwelve/functions.php
@@ -309,7 +309,7 @@ add_filter( 'mce_css', 'twentytwelve_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 ) {
diff --git a/wp-includes/class-wp-theme.php b/wp-includes/class-wp-theme.php
index 6a18e7a534..a26c7bbd94 100644
--- a/wp-includes/class-wp-theme.php
+++ b/wp-includes/class-wp-theme.php
@@ -246,7 +246,7 @@ final class WP_Theme implements ArrayAccess {
*
* @param string $theme_dir Directory of the theme within the theme_root.
* @param string $theme_root Theme root.
- * @param WP_Theme|null $_child If this theme is a parent theme, the child may be passed for validation purposes.
+ * @param WP_Theme|null $_child If this theme is a parent theme, the child may be passed for validation purposes.
*/
public function __construct( $theme_dir, $theme_root, $_child = null ) {
global $wp_theme_directories;
diff --git a/wp-includes/theme.php b/wp-includes/theme.php
index 3262ebde13..9c18c71792 100644
--- a/wp-includes/theme.php
+++ b/wp-includes/theme.php
@@ -1010,7 +1010,7 @@ function validate_theme_requirements( $stylesheet ) {
* @since 6.9.0
*
* @param bool|WP_Error $met_requirements True if the theme meets requirements, WP_Error if not.
- * @param string $stylesheet Directory name for the theme.
+ * @param string $stylesheet Directory name for the theme.
*/
return apply_filters( 'validate_theme_requirements', true, $stylesheet );
}
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 6905c3e428..e0ff8f1616 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
*
* @global string $wp_version
*/
-$wp_version = '7.2-alpha-63493';
+$wp_version = '7.2-alpha-63494';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.