diff --git a/wp-admin/includes/class-wp-list-table.php b/wp-admin/includes/class-wp-list-table.php index 3d4f23e286..b0150f1821 100644 --- a/wp-admin/includes/class-wp-list-table.php +++ b/wp-admin/includes/class-wp-list-table.php @@ -797,11 +797,22 @@ class WP_List_Table { /** * Filters the number of items to be displayed on each page of the list table. * - * The dynamic hook name, $option, refers to the `per_page` option depending - * on the type of list table in use. Possible values include: 'edit_comments_per_page', - * 'sites_network_per_page', 'site_themes_network_per_page', 'themes_network_per_page', - * 'users_network_per_page', 'edit_post_per_page', 'edit_page_per_page', - * 'edit_{$post_type}_per_page', etc. + * The dynamic hook name, `$option`, refers to the `per_page` option depending + * on the type of list table in use. Possible filter names include: + * + * - `edit_comments_per_page` + * - `sites_network_per_page` + * - `site_themes_network_per_page` + * - `themes_network_per_page'` + * - `users_network_per_page` + * - `edit_post_per_page` + * - `edit_page_per_page'` + * - `edit_{$post_type}_per_page` + * - `edit_post_tag_per_page` + * - `edit_category_per_page` + * - `edit_{$taxonomy}_per_page` + * - `site_users_network_per_page` + * - `users_per_page` * * @since 2.9.0 * diff --git a/wp-includes/class-http.php b/wp-includes/class-http.php index 772cb5581d..4525cc6380 100644 --- a/wp-includes/class-http.php +++ b/wp-includes/class-http.php @@ -237,20 +237,20 @@ class WP_Http { } /** - * Filters whether to preempt an HTTP request's return value. + * Filters the preemptive return value of an HTTP request. * * Returning a non-false value from the filter will short-circuit the HTTP request and return - * early with that value. A filter should return either: + * early with that value. A filter should return one of: * * - An array containing 'headers', 'body', 'response', 'cookies', and 'filename' elements * - A WP_Error instance - * - boolean false (to avoid short-circuiting the response) + * - boolean false to avoid short-circuiting the response * * Returning any other value may result in unexpected behaviour. * * @since 2.9.0 * - * @param false|array|WP_Error $preempt Whether to preempt an HTTP request's return value. Default false. + * @param false|array|WP_Error $preempt A preemptive return value of an HTTP request. Default false. * @param array $parsed_args HTTP request arguments. * @param string $url The request URL. */ diff --git a/wp-includes/class-wp-date-query.php b/wp-includes/class-wp-date-query.php index a86ed6da82..1e6c048230 100644 --- a/wp-includes/class-wp-date-query.php +++ b/wp-includes/class-wp-date-query.php @@ -45,7 +45,7 @@ class WP_Date_Query { * The value comparison operator. Can be changed via the query arguments. * * @since 3.7.0 - * @var array + * @var string */ public $compare = '='; diff --git a/wp-includes/class-wp-dependency.php b/wp-includes/class-wp-dependency.php index deb2b37807..d941491976 100644 --- a/wp-includes/class-wp-dependency.php +++ b/wp-includes/class-wp-dependency.php @@ -21,7 +21,7 @@ class _WP_Dependency { * The handle name. * * @since 2.6.0 - * @var null + * @var string */ public $handle; @@ -29,7 +29,7 @@ class _WP_Dependency { * The handle source. * * @since 2.6.0 - * @var null + * @var string */ public $src; @@ -55,7 +55,7 @@ class _WP_Dependency { * Additional arguments for the handle. * * @since 2.6.0 - * @var null + * @var array */ public $args = null; // Custom property, such as $in_footer or $media. diff --git a/wp-includes/class-wp-post-type.php b/wp-includes/class-wp-post-type.php index be156f5fd1..db2eb6b47d 100644 --- a/wp-includes/class-wp-post-type.php +++ b/wp-includes/class-wp-post-type.php @@ -200,7 +200,7 @@ final class WP_Post_Type { * Do `remove_meta_box()` and `add_meta_box()` calls in the callback. Default null. * * @since 4.6.0 - * @var string $register_meta_box_cb + * @var callable $register_meta_box_cb */ public $register_meta_box_cb = null; diff --git a/wp-includes/class-wp-query.php b/wp-includes/class-wp-query.php index da812c7bd3..d339285506 100644 --- a/wp-includes/class-wp-query.php +++ b/wp-includes/class-wp-query.php @@ -655,7 +655,7 @@ class WP_Query { * @type int $hour Hour of the day. Default empty. Accepts numbers 0-23. * @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. + * Default false. * @type int $m Combination YearMonth. Accepts any four-digit year and month * numbers 1-12. Default empty. * @type string $meta_compare Comparison operator to test the 'meta_value'. @@ -685,7 +685,6 @@ class WP_Query { * 'post_name__in', 'post_parent__in', and the array keys * of `$meta_query`. Default is 'date', except when a search * is being performed, when the default is 'relevance'. - * * @type int $p Post ID. * @type int $page Show the number of posts that would show up on page X of a * static front page. @@ -3434,6 +3433,8 @@ class WP_Query { * * @since 1.5.0 * + * @see WP_Query::parse_query() for all available arguments. + * * @param string|array $query URL query string or array of query arguments. * @return WP_Post[]|int[] Array of post objects or post IDs. */ @@ -3546,6 +3547,8 @@ class WP_Query { * * @since 1.5.0 * + * @see WP_Query::parse_query() for all available arguments. + * * @param string|array $query URL query string or array of vars. */ public function __construct( $query = '' ) { diff --git a/wp-includes/post.php b/wp-includes/post.php index 65c7b6c15c..85397787ae 100644 --- a/wp-includes/post.php +++ b/wp-includes/post.php @@ -2355,7 +2355,7 @@ function sanitize_post( $post, $context = 'display' ) { } /** - * Sanitize post field based on context. + * Sanitizes a post field based on context. * * Possible context values are: 'raw', 'edit', 'db', 'display', 'attribute' and * 'js'. The 'display' context is used by default. 'attribute' and 'js' contexts @@ -2367,7 +2367,7 @@ function sanitize_post( $post, $context = 'display' ) { * @param string $field The Post Object field name. * @param mixed $value The Post Object value. * @param int $post_id Post ID. - * @param string $context Optional. How to sanitize post fields. Looks for 'raw', 'edit', + * @param string $context Optional. How to sanitize the field. Possible values are 'raw', 'edit', * 'db', 'display', 'attribute' and 'js'. Default 'display'. * @return mixed Sanitized value. */ @@ -2494,7 +2494,7 @@ function sanitize_post_field( $field, $value, $post_id, $context = 'display' ) { * @param mixed $value Value of the prefixed post field. * @param int $post_id Post ID. * @param string $context Context for how to sanitize the field. Possible - * values include 'raw', 'edit', 'db', 'display', + * values include 'edit', 'display', * 'attribute' and 'js'. */ $value = apply_filters( "{$field}", $value, $post_id, $context ); diff --git a/wp-includes/version.php b/wp-includes/version.php index 115591ea42..66635c21e0 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -13,7 +13,7 @@ * * @global string $wp_version */ -$wp_version = '5.5-beta1-48461'; +$wp_version = '5.5-beta1-48462'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.