From e23009522571e488111f63f7854460b6af03b954 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <info@drewapicture.com>
Date: Thu, 3 Mar 2016 07:04:25 +0000
Subject: [PATCH] Docs: Use third-person singular verbs in DocBlock summaries
 for the `WP_Site_Logo` class, introduced in [36698].

Also minorly improves various inline docs.

See #33755. See #35986.

Built from https://develop.svn.wordpress.org/trunk@36820


git-svn-id: http://core.svn.wordpress.org/trunk@36787 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-admin/includes/class-wp-site-logo.php | 20 +++++++++++---------
 wp-includes/version.php                  |  2 +-
 2 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/wp-admin/includes/class-wp-site-logo.php b/wp-admin/includes/class-wp-site-logo.php
index aff3d3e61b..d1cc15d184 100644
--- a/wp-admin/includes/class-wp-site-logo.php
+++ b/wp-admin/includes/class-wp-site-logo.php
@@ -27,7 +27,7 @@ class WP_Site_Logo {
 	}
 
 	/**
-	 * Hide header text on front end if necessary.
+	 * Hides header text on the front end if necessary.
 	 *
 	 * @since 4.5.0
 	 * @access public
@@ -38,7 +38,7 @@ class WP_Site_Logo {
 			return;
 		}
 
-		// Is Display Header Text unchecked? If so, we need to hide our header text.
+		// Is Display Header Text unchecked? If so, hide the header text.
 		?>
 		<!-- Site Logo: hide header text -->
 		<style type="text/css">
@@ -51,12 +51,12 @@ class WP_Site_Logo {
 	}
 
 	/**
-	 * Reset the site logo if the current logo is deleted in the media manager.
+	 * Resets the site logo if the current logo is deleted in the media manager.
 	 *
 	 * @since 4.5.0
 	 * @access public
 	 *
-	 * @param int $post_id
+	 * @param int $post_id Post ID.
 	 */
 	public function delete_attachment_data( $post_id ) {
 		$site_logo_id = get_theme_mod( 'site_logo' );
@@ -67,7 +67,7 @@ class WP_Site_Logo {
 	}
 
 	/**
-	 * Make custom image sizes available to the media manager.
+	 * Makes custom image sizes available to the media manager.
 	 *
 	 * @since 4.5.0
 	 * @access public
@@ -80,7 +80,7 @@ class WP_Site_Logo {
 		// Get an array of all registered image sizes.
 		$intermediate = get_intermediate_image_sizes();
 
-		// Have we got anything fun to work with?
+		// Is there anything fun to work with?
 		if ( is_array( $intermediate ) && ! empty( $intermediate ) ) {
 			foreach ( $intermediate as $key => $size ) {
 
@@ -95,12 +95,14 @@ class WP_Site_Logo {
 	}
 
 	/**
-	 * Get header text classes. If not defined in add_theme_support(), defaults from Underscores will be used.
+	 * Retrieves the header text classes.
+	 *
+	 * If not defined in add_theme_support(), defaults from Underscores will be used.
 	 *
 	 * @since 4.5.0
 	 * @access protected
 	 *
-	 * @return string String of classes to hide
+	 * @return string String of classes to hide.
 	 */
 	protected function header_text_classes() {
 		$args = get_theme_support( 'site-logo' );
@@ -116,7 +118,7 @@ class WP_Site_Logo {
 			);
 		}
 
-		// If we've got an array, reduce them to a string for output.
+		// If there's an array of classes, reduce them to a string for output.
 		if ( is_array( $classes ) ) {
 			$classes = array_map( 'sanitize_html_class', $classes );
 			$classes = (string) '.' . implode( ', .', $classes );
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 720cdc60d9..6cdd15f87d 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -4,7 +4,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '4.5-beta2-36819';
+$wp_version = '4.5-beta2-36820';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.