Changeset 63596

Timestamp:

09/10/2026 10:57:55 PM (4 weeks ago)

Author:

westonruter

Message:

Docs: Use the bool and int short type forms in PHPDoc.

The PHP inline documentation standards call for bool and int in @param, @return and @global tags, but six docblocks in src/wp-includes still carried the long boolean and integer spellings.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/13476.
Follow-up to r63495.

Props njones35.
See #65860.

Location:

trunk/src/wp-includes

Files:

• class-wp-theme-json.php (modified) (1 diff)
• global-styles-and-settings.php (modified) (1 diff)
• html-api/class-wp-html-tag-processor.php (modified) (1 diff)
• media.php (modified) (1 diff)
• rest-api/endpoints/class-wp-rest-global-styles-controller.php (modified) (1 diff)
• rest-api/endpoints/class-wp-rest-templates-controller.php (modified) (1 diff)

trunk/src/wp-includes/class-wp-theme-json.php

@@ -3010 +3010 @@
          * @since 6.7.0 `ref` resolution of background properties, and assigning custom default values.
          *
-         * @param array   $styles           Styles to process.
-         * @param array   $settings         Theme settings.
-         * @param array   $properties       Properties metadata.
-         * @param array   $theme_json       Theme JSON array.
-         * @param string  $selector         The style block selector.
-         * @param boolean $use_root_padding Whether to add custom properties at root level.
+         * @param array  $styles           Styles to process.
+         * @param array  $settings         Theme settings.
+         * @param array  $properties       Properties metadata.
+         * @param array  $theme_json       Theme JSON array.
+         * @param string $selector         The style block selector.
+         * @param bool   $use_root_padding Whether to add custom properties at root level.
          * @return array Returns the modified $declarations.
          */

trunk/src/wp-includes/global-styles-and-settings.php

@@ -498 +498 @@
  * @param WP_Block_Type $block_type The block's type.
  * @param string|array  $target     The desired selector's target, `root` or array path.
- * @param boolean       $fallback   Whether to fall back to broader selector.
+ * @param bool          $fallback   Whether to fall back to broader selector.
  * @return string|null CSS selector or `null` if no selector available.
  */

trunk/src/wp-includes/html-api/class-wp-html-tag-processor.php

@@ -2790 +2790 @@
          *
          * @param string $comparable_name The attribute name in its comparable form.
-         * @return string|boolean|null Value of enqueued update if present, otherwise false.
+         * @return string|bool|null Value of enqueued update if present, otherwise false.
          */
         private function get_enqueued_attribute_value( string $comparable_name ) {

trunk/src/wp-includes/media.php

@@ -2121 +2121 @@
          * @since 6.7.1
          *
-         * @param boolean $enabled Whether auto-sizes for lazy loaded images is enabled.
+         * @param bool $enabled Whether auto-sizes for lazy loaded images is enabled.
          */
         if ( ! apply_filters( 'wp_img_tag_add_auto_sizes', true ) ) {

trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-global-styles-controller.php

@@ -387 +387 @@
          * @since 6.3.0 Adds revisions count and rest URL href to version-history.
          *
-         * @param integer $id ID.
+         * @param int $id ID.
          * @return array Links for the given post.
          */

trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-templates-controller.php

@@ -968 +968 @@
          * @since 5.8.0
          *
-         * @param integer $id ID.
+         * @param int $id ID.
          * @return array Links for the given post.
          */