Twenty Seventeen: Document the $twentyseventeencounter global.

Follow-up to [38833], [38986], [55003].

See #57069, #56792.

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

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

@@ -125,7 +125,8 @@ endif;
 /**
  * Display a front page section.
  *
- * @global WP_Post $post Global post object.
+ * @global int|string $twentyseventeencounter Front page section counter.
+ * @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,9 +488,9 @@ 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
+	 *
+	 * @global WP_Post $post Global post object.
 	 */
 	function twentythirteen_post_nav() {
 		global $post;

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

@@ -427,9 +427,9 @@ 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
+	 *
+	 * @global WP_Post $post Global post object.
 	 */
 	function twentytwelve_comment( $comment, $args, $depth ) {
 		$GLOBALS['comment'] = $comment;