From f22633f20b4e3d2655fd1f8685da21d204247188 Mon Sep 17 00:00:00 2001 From: Sergey Biryukov Date: Thu, 5 Nov 2020 09:42:10 +0000 Subject: [PATCH] Docs: Consistently place `@see` tags after `@since` in `WP_Query` methods, per the documentation standards. See #50768. Built from https://develop.svn.wordpress.org/trunk@49505 git-svn-id: http://core.svn.wordpress.org/trunk@49260 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-includes/class-wp-query.php | 16 ++++++++-------- wp-includes/query.php | 21 ++++++++------------- wp-includes/version.php | 2 +- 3 files changed, 17 insertions(+), 22 deletions(-) diff --git a/wp-includes/class-wp-query.php b/wp-includes/class-wp-query.php index 2fe6ee7418..0924088cfa 100644 --- a/wp-includes/class-wp-query.php +++ b/wp-includes/class-wp-query.php @@ -3944,10 +3944,10 @@ class WP_Query { * If you set a static page for the front page of your site, this function will return * true only on the page you set as the "Posts page". * - * @see WP_Query::is_front_page() - * * @since 3.1.0 * + * @see WP_Query::is_front_page() + * * @return bool Whether the query is for the blog homepage. */ public function is_home() { @@ -3994,11 +3994,11 @@ class WP_Query { * If the $page parameter is specified, this function will additionally * check if the query is for one of the pages specified. * + * @since 3.1.0 + * * @see WP_Query::is_single() * @see WP_Query::is_singular() * - * @since 3.1.0 - * * @param int|string|int[]|string[] $page Optional. Page ID, title, slug, path, or array of such * to check against. Default empty. * @return bool Whether the query is for an existing single page. @@ -4101,11 +4101,11 @@ class WP_Query { * If the $post parameter is specified, this function will additionally * check if the query is for one of the Posts specified. * + * @since 3.1.0 + * * @see WP_Query::is_page() * @see WP_Query::is_singular() * - * @since 3.1.0 - * * @param int|string|int[]|string[] $post Optional. Post ID, title, slug, path, or array of such * to check against. Default empty. * @return bool Whether the query is for an existing single post. @@ -4151,11 +4151,11 @@ class WP_Query { * If the $post_types parameter is specified, this function will additionally * check if the query is for one of the Posts Types specified. * + * @since 3.1.0 + * * @see WP_Query::is_page() * @see WP_Query::is_single() * - * @since 3.1.0 - * * @param string|string[] $post_types Optional. Post type or array of post types * to check against. Default empty. * @return bool Whether the query is for an existing single post diff --git a/wp-includes/query.php b/wp-includes/query.php index 7a3a737239..d9de9e7c89 100644 --- a/wp-includes/query.php +++ b/wp-includes/query.php @@ -563,11 +563,10 @@ function is_month() { * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ * Conditional Tags} article in the Theme Developer Handbook. * - * @see is_single() - * @see is_singular() - * * @since 1.5.0 * + * @see is_single() + * @see is_singular() * @global WP_Query $wp_query WordPress Query object. * * @param int|string|int[]|string[] $page Optional. Page ID, title, slug, or array of such @@ -709,11 +708,10 @@ function is_search() { * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ * Conditional Tags} article in the Theme Developer Handbook. * - * @see is_page() - * @see is_singular() - * * @since 1.5.0 * + * @see is_page() + * @see is_singular() * @global WP_Query $wp_query WordPress Query object. * * @param int|string|int[]|string[] $post Optional. Post ID, title, slug, or array of such @@ -742,11 +740,10 @@ function is_single( $post = '' ) { * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ * Conditional Tags} article in the Theme Developer Handbook. * - * @see is_page() - * @see is_single() - * * @since 1.5.0 * + * @see is_page() + * @see is_single() * @global WP_Query $wp_query WordPress Query object. * * @param string|string[] $post_types Optional. Post type or array of post types @@ -1083,11 +1080,10 @@ function wp_old_slug_redirect() { /** * Find the post ID for redirecting an old slug. * - * @see wp_old_slug_redirect() - * * @since 4.9.3 * @access private * + * @see wp_old_slug_redirect() * @global wpdb $wpdb WordPress database abstraction object. * * @param string $post_type The current post type based on the query vars. @@ -1118,11 +1114,10 @@ function _find_post_by_old_slug( $post_type ) { /** * Find the post ID for redirecting an old date. * - * @see wp_old_slug_redirect() - * * @since 4.9.3 * @access private * + * @see wp_old_slug_redirect() * @global wpdb $wpdb WordPress database abstraction object. * * @param string $post_type The current post type based on the query vars. diff --git a/wp-includes/version.php b/wp-includes/version.php index c79aaddfcc..a4b0f45272 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -13,7 +13,7 @@ * * @global string $wp_version */ -$wp_version = '5.6-beta3-49504'; +$wp_version = '5.6-beta3-49505'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.