Commit 3f6c31ea6c for wordpress.org
commit 3f6c31ea6c0ec9eace0c8f21a4b795950b78e440
Author: wildworks <wildworks@git.wordpress.org>
Date: Sat Sep 5 08:52:51 2026 +0000
Docs: Align `@param` tag columns in administration docblocks.
Aligns `@param` tag columns in docblocks across the administration screens per the PHP inline documentation standards.
Developed in: https://github.com/WordPress/wordpress-develop/pull/13316
Props mukesh27, wildworks.
See #65818.
Built from https://develop.svn.wordpress.org/trunk@63492
git-svn-id: http://core.svn.wordpress.org/trunk@62668 1a063a9b-81f0-0310-95a4-ce76da25c4cd
diff --git a/wp-admin/includes/class-wp-community-events.php b/wp-admin/includes/class-wp-community-events.php
index a31b3651b9..d6a0c8161a 100644
--- a/wp-admin/includes/class-wp-community-events.php
+++ b/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.
*
diff --git a/wp-admin/includes/class-wp-internal-pointers.php b/wp-admin/includes/class-wp-internal-pointers.php
index 9a2135b527..22233884b4 100644
--- a/wp-admin/includes/class-wp-internal-pointers.php
+++ b/wp-admin/includes/class-wp-internal-pointers.php
@@ -109,8 +109,8 @@ final class WP_Internal_Pointers {
* @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'] ) ) {
diff --git a/wp-admin/includes/class-wp-list-table.php b/wp-admin/includes/class-wp-list-table.php
index 17ec0c28f5..df8e71834e 100644
--- a/wp-admin/includes/class-wp-list-table.php
+++ b/wp-admin/includes/class-wp-list-table.php
@@ -733,7 +733,7 @@ class WP_List_Table {
*
* @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 );
diff --git a/wp-admin/includes/class-wp-posts-list-table.php b/wp-admin/includes/class-wp-posts-list-table.php
index bb8382569d..d3d631b9b4 100644
--- a/wp-admin/includes/class-wp-posts-list-table.php
+++ b/wp-admin/includes/class-wp-posts-list-table.php
@@ -1854,7 +1854,7 @@ class WP_Posts_List_Table extends WP_List_Table {
* @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 );
diff --git a/wp-admin/includes/class-wp-terms-list-table.php b/wp-admin/includes/class-wp-terms-list-table.php
index 561888fed8..9481f0967a 100644
--- a/wp-admin/includes/class-wp-terms-list-table.php
+++ b/wp-admin/includes/class-wp-terms-list-table.php
@@ -395,8 +395,8 @@ class WP_Terms_List_Table extends WP_List_Table {
*
* @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 );
diff --git a/wp-admin/includes/list-table.php b/wp-admin/includes/list-table.php
index 1e2c190c80..97dfe4f858 100644
--- a/wp-admin/includes/list-table.php
+++ b/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.
diff --git a/wp-admin/includes/template.php b/wp-admin/includes/template.php
index e7034e1499..a24aae32cc 100644
--- a/wp-admin/includes/template.php
+++ b/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 ) {
diff --git a/wp-includes/class-walker-nav-menu.php b/wp-includes/class-walker-nav-menu.php
index 3d9f442bb8..8047047757 100644
--- a/wp-includes/class-walker-nav-menu.php
+++ b/wp-includes/class-walker-nav-menu.php
@@ -99,13 +99,13 @@ class Walker_Nav_Menu extends Walker {
*
* @since 6.3.0
*
- * @param array $atts {
+ * @param array $atts {
* The HTML attributes applied to the `<ul>` element, empty strings are ignored.
*
* @type string $class HTML CSS class attribute.
* }
- * @param stdClass $args An object of `wp_nav_menu()` arguments.
- * @param int $depth Depth of menu item. Used for padding.
+ * @param stdClass $args An object of `wp_nav_menu()` arguments.
+ * @param int $depth Depth of menu item. Used for padding.
*/
$atts = apply_filters( 'nav_menu_submenu_attributes', $atts, $args, $depth );
$attributes = $this->build_atts( $atts );
@@ -215,7 +215,7 @@ class Walker_Nav_Menu extends Walker {
*
* @since 6.3.0
*
- * @param array $li_atts {
+ * @param array $li_atts {
* The HTML attributes applied to the menu item's `<li>` element, empty strings are ignored.
*
* @type string $class HTML CSS class attribute.
@@ -281,7 +281,7 @@ class Walker_Nav_Menu extends Walker {
* @since 3.6.0
* @since 4.1.0 The `$depth` parameter was added.
*
- * @param array $atts {
+ * @param array $atts {
* The HTML attributes applied to the menu item's `<a>` element, empty strings are ignored.
*
* @type string $title Title attribute.
diff --git a/wp-includes/class-walker-page.php b/wp-includes/class-walker-page.php
index bb3929a9dd..32f1e9c055 100644
--- a/wp-includes/class-walker-page.php
+++ b/wp-includes/class-walker-page.php
@@ -176,7 +176,7 @@ class Walker_Page extends Walker {
*
* @since 4.8.0
*
- * @param array $atts {
+ * @param array $atts {
* The HTML attributes applied to the menu item's `<a>` element, empty strings are ignored.
*
* @type string $href The href attribute.
diff --git a/wp-includes/class-wp-admin-bar.php b/wp-includes/class-wp-admin-bar.php
index 0cf2cad3fc..200d915200 100644
--- a/wp-includes/class-wp-admin-bar.php
+++ b/wp-includes/class-wp-admin-bar.php
@@ -504,7 +504,7 @@ class WP_Admin_Bar {
* @since 3.3.0
* @since 6.5.0 Added `$menu_title` parameter to allow an ARIA menu name.
*
- * @param object $node
+ * @param object $node
* @param string|bool $menu_title The accessible name of this ARIA menu or false if not provided.
*/
final protected function _render_group( $node, $menu_title = false ) {
diff --git a/wp-includes/class-wp-customize-manager.php b/wp-includes/class-wp-customize-manager.php
index d7d55e41a1..b02a48fec8 100644
--- a/wp-includes/class-wp-customize-manager.php
+++ b/wp-includes/class-wp-customize-manager.php
@@ -3250,7 +3250,7 @@ final class WP_Customize_Manager {
* @since 4.9.0
*
* @param int $changeset_post_id Changeset post ID.
- * @param bool $take_over Whether to take over the changeset. Default false.
+ * @param bool $take_over Whether to take over the changeset. Default false.
*/
public function set_changeset_lock( $changeset_post_id, $take_over = false ) {
if ( $changeset_post_id ) {
diff --git a/wp-includes/customize/class-wp-customize-selective-refresh.php b/wp-includes/customize/class-wp-customize-selective-refresh.php
index 3077d09dcf..c4f0d5d3f9 100644
--- a/wp-includes/customize/class-wp-customize-selective-refresh.php
+++ b/wp-includes/customize/class-wp-customize-selective-refresh.php
@@ -417,7 +417,7 @@ final class WP_Customize_Selective_Refresh {
*
* @since 4.5.0
*
- * @param array $response {
+ * @param array $response {
* Response.
*
* @type array $contents Associative array mapping a partial ID its corresponding array of contents
diff --git a/wp-includes/version.php b/wp-includes/version.php
index dc615244fd..1be54cd33b 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
*
* @global string $wp_version
*/
-$wp_version = '7.2-alpha-63491';
+$wp_version = '7.2-alpha-63492';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
diff --git a/wp-includes/widgets.php b/wp-includes/widgets.php
index 7a3cb5673a..fb4f3d2b05 100644
--- a/wp-includes/widgets.php
+++ b/wp-includes/widgets.php
@@ -1999,7 +1999,7 @@ function wp_assign_widget_to_sidebar( $widget_id, $sidebar_id ) {
* @global array $wp_registered_widgets The registered widgets.
* @global array $wp_registered_sidebars The registered sidebars.
*
- * @param string $widget_id Widget ID.
+ * @param string $widget_id Widget ID.
* @param string $sidebar_id Sidebar ID.
* @return string
*/