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

Props upadalavipul, audrasjb.

See #57069, #56792.


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

src/wp-content/themes/twentyseventeen/inc/template-tags.php

@@ -125,6 +125,8 @@ endif;
 /**
  * Display a front page section.
  *
+ * @global WP_Post $post Global post object.
+ *
  * @param WP_Customize_Partial $partial Partial associated with a selective refresh request.
  * @param int                  $id Front page section to display.
  */

src/wp-content/themes/twentythirteen/functions.php

@@ -488,6 +488,8 @@ if ( ! function_exists( 'twentythirteen_post_nav' ) ) :
 	/**
 	 * Display navigation to next/previous post when applicable.
 	 *
+	 * @global WP_Post $post Global post object.
+	 *
 	 * @since Twenty Thirteen 1.0
 	 */
 	function twentythirteen_post_nav() {

src/wp-content/themes/twentytwelve/functions.php

@@ -427,6 +427,8 @@ if ( ! function_exists( 'twentytwelve_comment' ) ) :
 	 *
 	 * Used as a callback by wp_list_comments() for displaying the comments.
 	 *
+	 * @global WP_Post $post Global post object.
+	 *
 	 * @since Twenty Twelve 1.0
 	 */
 	function twentytwelve_comment( $comment, $args, $depth ) {

src/wp-content/themes/twentytwenty/inc/template-tags.php

@@ -241,6 +241,8 @@ add_filter( 'edit_post_link', 'twentytwenty_edit_post_link', 10, 3 );
  *
  * @since Twenty Twenty 1.0
  *
+ * @global WP_Post $post Global post object.
+ *
  * @param int    $post_id  The ID of the post.
  * @param string $location The location where the meta is shown.
  */
@@ -651,6 +653,8 @@ add_action( 'wp_head', 'twentytwenty_no_js_class' );
  *
  * @since Twenty Twenty 1.0
  *
+ * @global WP_Post $post Global post object.
+ *
  * @param array $classes Classes added to the body tag.
  * @return array Classes added to the body tag.
  */