Correct the `@param` docs for arguments that are truthy/falsey.

See #30799.

Built from https://develop.svn.wordpress.org/trunk@30983


git-svn-id: http://core.svn.wordpress.org/trunk@30969 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-admin/includes/template.php

@@ -710,10 +710,10 @@ function meta_form( $post = null ) {
  *
  * @since 0.71
  *
- * @param int $edit      Accepts 1|true for editing the date, 0|false for adding the date.
+ * @param int|bool $edit      Accepts 1|true for editing the date, 0|false for adding the date.
- * @param int $for_post  Accepts 1|true for applying the date to a post, 0|false for a comment.
+ * @param int|bool $for_post  Accepts 1|true for applying the date to a post, 0|false for a comment.
- * @param int $tab_index The tabindex attribute to add. Default 0.
+ * @param int      $tab_index The tabindex attribute to add. Default 0.
- * @param int $multi     Optional. Whether the additional fields and buttons should be added.
+ * @param int|bool $multi     Optional. Whether the additional fields and buttons should be added.
  *                            Default 0|false.
  */
 function touch_time( $edit = 1, $for_post = 1, $tab_index = 0, $multi = 0 ) {

wp-includes/general-template.php

@@ -1312,7 +1312,7 @@ function get_archives_link($url, $text, $format = 'html', $before = '', $after =
  *     @type string     $before          Markup to prepend to the beginning of each link. Default empty.
  *     @type string     $after           Markup to append to the end of each link. Default empty.
  *     @type bool       $show_post_count Whether to display the post count alongside the link. Default false.
- *     @type bool       $echo            Whether to echo or return the links list. Default 1|true to echo.
+ *     @type bool|int   $echo            Whether to echo or return the links list. Default 1|true to echo.
  *     @type string     $order           Whether to use ascending or descending order. Accepts 'ASC', or 'DESC'.
  *                                       Default 'DESC'.
  * }

wp-includes/load.php

@@ -217,13 +217,13 @@ function timer_start() {
  *
  * @since 0.71
  *
- * @global float $timestart Seconds from when timer_start() is called.
+ * @global float   $timestart Seconds from when timer_start() is called.
- * @global float $timeend   Seconds from when function is called.
+ * @global float   $timeend   Seconds from when function is called.
  *
- * @param int $display   Whether to echo or return the results. Accepts 0|false for return,
+ * @param int|bool $display   Whether to echo or return the results. Accepts 0|false for return,
- *                       1|true for echo. Default 0|false.
+ *                            1|true for echo. Default 0|false.
- * @param int $precision The number of digits from the right of the decimal to display.
+ * @param int      $precision The number of digits from the right of the decimal to display.
- *                       Default 3.
+ *                            Default 3.
  * @return string The "second.microsecond" finished time calculation. The number is formatted
  *                for human consumption, both localized and rounded.
  */

wp-includes/post-template.php

@@ -1111,15 +1111,15 @@ function wp_list_pages( $args = '' ) {
  *     Optional. Arguments to generate a page menu. {@see wp_list_pages()}
  *     for additional arguments.
  *
- * @type string     $sort_column How to short the list of pages. Accepts post column names.
+ * @type string          $sort_column How to short the list of pages. Accepts post column names.
- *                               Default 'menu_order, post_title'.
+ *                                    Default 'menu_order, post_title'.
- * @type string     $menu_class  Class to use for the div ID containing the page list. Default 'menu'.
+ * @type string          $menu_class  Class to use for the div ID containing the page list. Default 'menu'.
- * @type bool       $echo        Whether to echo the list or return it. Accepts true (echo) or false (return).
+ * @type bool            $echo        Whether to echo the list or return it. Accepts true (echo) or false (return).
- *                               Default true.
+ *                                    Default true.
- * @type string     $link_before The HTML or text to prepend to $show_home text. Default empty.
+ * @type string          $link_before The HTML or text to prepend to $show_home text. Default empty.
- * @type string     $link_after  The HTML or text to append to $show_home text. Default empty.
+ * @type string          $link_after  The HTML or text to append to $show_home text. Default empty.
- * @type int|string $show_home   Whether to display the link to the home page. Can just enter the text
+ * @type int|bool|string $show_home   Whether to display the link to the home page. Can just enter the text
- *                               you'd like shown for the home link. 1|true defaults to 'Home'.
+ *                                    you'd like shown for the home link. 1|true defaults to 'Home'.
  * }
  * @return string html menu
  */

wp-includes/query.php

@@ -1472,7 +1472,7 @@ class WP_Query {
 	 *                                                 or array of fields. 'id=>parent' uses 'id' and 'post_parent'.
 	 *                                                 Default all fields. Accepts 'ids', 'id=>parent'.
 	 *     @type int          $hour                    Hour of the day. Default empty. Accepts numbers 0-23.
-	 *     @type bool         $ignore_sticky_posts     Whether to ignore sticky posts or not. Setting this to false
+	 *     @type int|bool     $ignore_sticky_posts     Whether to ignore sticky posts or not. Setting this to false
 	 *                                                 excludes stickies from 'post__in'. Accepts 1|true, 0|false.
 	 *                                                 Default 0|false.
 	 *     @type int          $m                       Combination YearMonth. Accepts any four-digit year and month