Commit 3c7b5ea631 for wordpress.org
commit 3c7b5ea631c7ccc101bdb3cf5b984646fc382c57
Author: wildworks <wildworks@git.wordpress.org>
Date: Sat Sep 5 09:58:45 2026 +0000
Docs: Align `@param` tag columns in post, comment, taxonomy, and media docblocks.
Aligns `@param` tag columns in docblocks across the posts, comments, taxonomy, and media APIs per the PHP inline documentation standards.
Developed in: https://github.com/WordPress/wordpress-develop/pull/13315
Props mukesh27, wildworks.
See #65818.
Built from https://develop.svn.wordpress.org/trunk@63497
git-svn-id: http://core.svn.wordpress.org/trunk@62673 1a063a9b-81f0-0310-95a4-ce76da25c4cd
diff --git a/wp-admin/comment.php b/wp-admin/comment.php
index b834f7b594..ed93797a64 100644
--- a/wp-admin/comment.php
+++ b/wp-admin/comment.php
@@ -372,8 +372,8 @@ switch ( $action ) {
*
* @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 );
diff --git a/wp-admin/includes/media.php b/wp-admin/includes/media.php
index 76ea01868f..be10d2f7bf 100644
--- a/wp-admin/includes/media.php
+++ b/wp-admin/includes/media.php
@@ -3618,7 +3618,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 ) {
diff --git a/wp-admin/includes/post.php b/wp-admin/includes/post.php
index 12a798bc9d..40a51e6394 100644
--- a/wp-admin/includes/post.php
+++ b/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.
*/
diff --git a/wp-includes/class-wp-image-editor.php b/wp-includes/class-wp-image-editor.php
index 8401117836..90a9f12cf1 100644
--- a/wp-includes/class-wp-image-editor.php
+++ b/wp-includes/class-wp-image-editor.php
@@ -259,7 +259,7 @@ abstract class WP_Image_Editor {
*
* @param int $quality Quality level between 1 (low) and 100 (high).
* @param string $mime_type Image mime type.
- * @param array $size {
+ * @param array $size {
* Dimensions of the image.
*
* @type int $width The image width.
diff --git a/wp-includes/comment-template.php b/wp-includes/comment-template.php
index f96cf18f78..f706836217 100644
--- a/wp-includes/comment-template.php
+++ b/wp-includes/comment-template.php
@@ -925,7 +925,7 @@ function get_comments_number( $post = 0 ) {
* @since 1.5.0
*
* @param string|int $comments_number A string representing the number of comments a post has, otherwise 0.
- * @param int $post_id Post ID.
+ * @param int $post_id Post ID.
*/
return apply_filters( 'get_comments_number', $comments_number, $post_id );
}
diff --git a/wp-includes/comment.php b/wp-includes/comment.php
index 7557e9258c..817ad17fa9 100644
--- a/wp-includes/comment.php
+++ b/wp-includes/comment.php
@@ -1247,7 +1247,7 @@ function get_page_of_comment( $comment_id, $args = array() ) {
* @type int $per_page Number of comments per page.
* @type int $max_depth Maximum comment threading depth allowed.
* }
- * @param int $comment_id ID of the comment.
+ * @param int $comment_id ID of the comment.
*/
return apply_filters( 'get_page_of_comment', (int) $page, $args, $original_args, $comment_id );
}
@@ -3445,8 +3445,8 @@ function wp_should_disable_pings_for_environment() {
*
* @since 7.1.0
*
- * @param bool $should_disable Whether pings should be disabled. Default true
- * for non-production environments, false for production.
+ * @param bool $should_disable Whether pings should be disabled. Default true
+ * for non-production environments, false for production.
* @param string $environment_type The current environment type as returned by
* wp_get_environment_type().
*/
@@ -3685,7 +3685,7 @@ function trackback( $trackback_url, $title, $excerpt, $post_id ) {
* @since 1.2.0
*
* @param string $server Host of blog to connect to.
- * @param string $path Path to send the ping.
+ * @param string $path Path to send the ping.
*/
function weblog_ping( $server = '', $path = '' ) {
require_once ABSPATH . WPINC . '/class-IXR.php';
diff --git a/wp-includes/media.php b/wp-includes/media.php
index 580ba2cb75..be0b2fbf09 100644
--- a/wp-includes/media.php
+++ b/wp-includes/media.php
@@ -1619,7 +1619,7 @@ function wp_calculate_image_srcset( $size_array, $image_src, $image_meta, $attac
* pixel density value if paired with an 'x' descriptor.
* }
* }
- * @param array $size_array {
+ * @param array $size_array {
* An array of requested width and height values.
*
* @type int $0 The width in pixels.
@@ -4124,11 +4124,11 @@ function get_adjacent_image_link( $prev = true, $size = 'thumbnail', $text = fal
*
* @since 3.5.0
*
- * @param string $output Adjacent image HTML markup.
- * @param int $attachment_id Attachment ID
- * @param string|int[] $size Requested image size. Can be any registered image size name, or
- * an array of width and height values in pixels (in that order).
- * @param string $text Link text.
+ * @param string $output Adjacent image HTML markup.
+ * @param int $attachment_id Attachment ID
+ * @param string|int[] $size Requested image size. Can be any registered image size name, or
+ * an array of width and height values in pixels (in that order).
+ * @param string $text Link text.
*/
return apply_filters( "{$adjacent}_image_link", $output, $attachment_id, $size, $text );
}
diff --git a/wp-includes/meta.php b/wp-includes/meta.php
index c657c6c2e7..577785c216 100644
--- a/wp-includes/meta.php
+++ b/wp-includes/meta.php
@@ -1427,7 +1427,7 @@ function sanitize_meta( $meta_key, $meta_value, $object_type, $object_subtype =
* @type bool $revisions_enabled Whether to enable revisions support for this meta_key. Can only be used when the
* object type is 'post'.
* }
- * @param string|array $deprecated Deprecated. Use `$args` instead.
+ * @param string|array $deprecated Deprecated. Use `$args` instead.
* @return bool True if the meta key was successfully registered in the global array, false if not.
* Registering a meta key with distinct sanitize and auth callbacks will fire those callbacks,
* but will not add to the global registry.
diff --git a/wp-includes/post-template.php b/wp-includes/post-template.php
index beb53c92b0..86ea3eca58 100644
--- a/wp-includes/post-template.php
+++ b/wp-includes/post-template.php
@@ -1636,7 +1636,7 @@ function walk_page_dropdown_tree( ...$args ) {
* @param int|WP_Post $post Optional. Post ID or post object.
* @param bool $fullsize Optional. Whether to use full size. Default false.
* @param bool $deprecated Deprecated. Not used.
- * @param bool $permalink Optional. Whether to include permalink. Default false.
+ * @param bool $permalink Optional. Whether to include permalink. Default false.
*/
function the_attachment_link( $post = 0, $fullsize = false, $deprecated = false, $permalink = false ) {
if ( ! empty( $deprecated ) ) {
diff --git a/wp-includes/post.php b/wp-includes/post.php
index dca47155a1..87c4e9627b 100644
--- a/wp-includes/post.php
+++ b/wp-includes/post.php
@@ -6012,7 +6012,7 @@ function wp_set_post_categories( $post_id = 0, $post_categories = array(), $appe
*
* @param string $new_status Transition to this post status.
* @param string $old_status Previous post status.
- * @param WP_Post $post Post data.
+ * @param WP_Post $post Post data.
*/
function wp_transition_post_status( $new_status, $old_status, $post ) {
/**
@@ -8782,7 +8782,7 @@ function get_available_post_mime_types( $type = 'attachment' ) {
* @since 5.4.0 Added the `$unfiltered` parameter.
*
* @param int $attachment_id Attachment ID.
- * @param bool $unfiltered Optional. Passed through to `get_attached_file()`. Default false.
+ * @param bool $unfiltered Optional. Passed through to `get_attached_file()`. Default false.
* @return string|false Path to the original image file or false if the attachment is not an image.
*/
function wp_get_original_image_path( $attachment_id, $unfiltered = false ) {
diff --git a/wp-includes/taxonomy.php b/wp-includes/taxonomy.php
index 2e264ad4e4..6dbc336395 100644
--- a/wp-includes/taxonomy.php
+++ b/wp-includes/taxonomy.php
@@ -1833,8 +1833,8 @@ function sanitize_term_field( $field, $value, $term_id, $taxonomy, $context ) {
*
* @since 2.3.0
*
- * @param mixed $value Value of the term field.
- * @param int $term_id Term ID.
+ * @param mixed $value Value of the term field.
+ * @param int $term_id Term ID.
* @param string $taxonomy Taxonomy slug.
*/
$value = apply_filters( "edit_term_{$field}", $value, $term_id, $taxonomy );
@@ -3770,7 +3770,7 @@ function clean_object_term_cache( $object_ids, $object_type ) {
*
* @since 2.5.0
*
- * @param array $object_ids An array of object IDs.
+ * @param array $object_ids An array of object IDs.
* @param string $object_type Object type.
*/
do_action( 'clean_object_term_cache', $object_ids, $object_type );
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 658d05b1b9..7a75751891 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
*
* @global string $wp_version
*/
-$wp_version = '7.2-alpha-63496';
+$wp_version = '7.2-alpha-63497';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.