Docs: Improve various globals documentation, as per documentation standards.

Props upadalavipul, mukesh27, krupalpanchal, jigar-bhanushali.
See #57069, #56792.


git-svn-id: https://develop.svn.wordpress.org/trunk@54867 602fd350-edb4-49c9-b593-d223f7449a82

src/wp-admin/includes/class-wp-upgrader.php

@@ -911,6 +911,8 @@ class WP_Upgrader {
 	 *
 	 * @since 4.5.0
 	 *
+	 * @global wpdb $wpdb The WordPress database abstraction object.
+	 *
 	 * @param string $lock_name       The name of this unique lock.
 	 * @param int    $release_timeout Optional. The duration in seconds to respect an existing lock.
 	 *                                Default: 1 hour.

src/wp-includes/class-wp-block.php

@@ -196,6 +196,8 @@ class WP_Block {
 	 *
 	 * @since 5.5.0
 	 *
+	 * @global WP_Post $post Global post object.
+	 *
 	 * @param array $options {
 	 *     Optional options object.
 	 *

src/wp-includes/class-wp-locale.php

@@ -124,7 +124,6 @@ class WP_Locale {
 	 * @since 2.1.0
 	 *
 	 * @global string $text_direction
-	 * @global string $wp_version     The WordPress version string.
 	 */
 	public function init() {
 		// The weekdays.

src/wp-includes/class-wp-tax-query.php

@@ -589,8 +589,6 @@ class WP_Tax_Query {
 	 *
 	 * @since 3.2.0
 	 *
-	 * @global wpdb $wpdb The WordPress database abstraction object.
-	 *
 	 * @param array  $query           The single query. Passed by reference.
 	 * @param string $resulting_field The resulting field. Accepts 'slug', 'name', 'term_taxonomy_id',
 	 *                                or 'term_id'. Default 'term_id'.

src/wp-includes/class-wp-term-query.php

@@ -910,8 +910,6 @@ class WP_Term_Query {
 	 *
 	 * @since 4.6.0
 	 *
-	 * @global wpdb $wpdb WordPress database abstraction object.
-	 *
 	 * @param string $orderby_raw Alias for the field to order by.
 	 * @return string|false Value to used in the ORDER clause. False otherwise.
 	 */