Twenty Twelve: Add missing documentation for some global variables.

Props sabernhardt, upadalavipul, shailu25, rajinsharwar, audrasjb, viralsampat, noruzzaman, huzaifaalmesbah, SergeyBiryukov.
See #58715.

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

Author: SergeyBiryukov

src/wp-content/themes/twentyeleven/header.php

@@ -10,8 +10,8 @@
  */
 
 /**
- * @global int $page  WordPress paginated post page count.
- * @global int $paged WordPress archive pagination page count.
+ * @global int $page  Page number of a single post.
+ * @global int $paged Page number of a list of posts.
  */
 global $page, $paged;
 

src/wp-content/themes/twentyten/header.php

@@ -10,8 +10,8 @@
  */
 
 /**
- * @global int $page  WordPress paginated post page count.
- * @global int $paged WordPress archive pagination page count.
+ * @global int $page  Page number of a single post.
+ * @global int $paged Page number of a list of posts.
  */
 global $page, $paged;
 

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

@@ -43,6 +43,8 @@
  * @uses set_post_thumbnail_size() To set a custom post thumbnail size.
  *
  * @since Twenty Twelve 1.0
+ *
+ * @global string $wp_version The WordPress version string.
  */
 function twentytwelve_setup() {
 	/*
@@ -181,6 +183,8 @@ function twentytwelve_get_font_url() {
  * Enqueues scripts and styles for front end.
  *
  * @since Twenty Twelve 1.0
+ *
+ * @global WP_Styles $wp_styles The WP_Styles object for printing styles.
  */
 function twentytwelve_scripts_styles() {
 	global $wp_styles;
@@ -242,6 +246,8 @@ function twentytwelve_block_editor_styles() {
  * @since Twenty Twelve 2.2
  * @deprecated Twenty Twelve 3.9 Disabled filter because, by default, fonts are self-hosted.
  *
+ * @global string $wp_version The WordPress version string.
+ *
  * @param array   $urls          URLs to print for resource hints.
  * @param string  $relation_type The relation type the URLs are printed.
  * @return array URLs to print for resource hints.
@@ -299,6 +305,9 @@ function twentytwelve_mce_css( $mce_css ) {
  *
  * @since Twenty Twelve 1.0
  *
+ * @global int $paged Page number of a list of posts.
+ * @global int $page  Page number of a single post.
+ *
  * @param string $title Default title text for current view.
  * @param string $sep Optional separator.
  * @return string Filtered title.
@@ -411,6 +420,8 @@ function wp_get_list_item_separator() {
 	 * Displays navigation to next/previous pages when applicable.
 	 *
 	 * @since Twenty Twelve 1.0
+	 *
+	 * @global WP_Query $wp_query WordPress Query object.
 	 */
 	function twentytwelve_content_nav( $html_id ) {
 		global $wp_query;
@@ -451,7 +462,12 @@ function twentytwelve_content_nav( $html_id ) {
 	 *
 	 * @since Twenty Twelve 1.0
 	 *
-	 * @global WP_Post $post Global post object.
+	 * @global WP_Comment $comment Global comment object.
+	 * @global WP_Post    $post    Global post object.
+	 *
+	 * @param WP_Comment $comment The comment object.
+	 * @param array      $args    An array of comment arguments. @see get_comment_reply_link()
+	 * @param int        $depth   The depth of the comment.
 	 */
 	function twentytwelve_comment( $comment, $args, $depth ) {
 		$GLOBALS['comment'] = $comment;
@@ -644,6 +660,8 @@ function twentytwelve_body_class( $classes ) {
  * templates, and when there are no active widgets in the sidebar.
  *
  * @since Twenty Twelve 1.0
+ *
+ * @global int $content_width Content width.
  */
 function twentytwelve_content_width() {
 	if ( is_page_template( 'page-templates/full-width.php' ) || is_attachment() || ! is_active_sidebar( 'sidebar-1' ) ) {