From 2aff6bb86429923244e7c97d6945000e586d02e2 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <info@drewapicture.com>
Date: Sun, 6 Oct 2013 15:31:09 +0000
Subject: [PATCH] Inline documentation for hooks in wp-includes/update.php.

Props ShinichiN.
Fixes #25467.

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


git-svn-id: http://core.svn.wordpress.org/trunk@25614 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/update.php | 36 ++++++++++++++++++++++++++++++------
 1 file changed, 30 insertions(+), 6 deletions(-)

diff --git a/wp-includes/update.php b/wp-includes/update.php
index 79903f5a03..842b7f3719 100644
--- a/wp-includes/update.php
+++ b/wp-includes/update.php
@@ -42,7 +42,15 @@ function wp_version_check() {
 	if ( $time_not_changed )
 		return false;
 
-	$locale = apply_filters( 'core_version_check_locale', get_locale() );
+	$locale = get_locale();
+	/**
+	 * Filter the locale requested for WordPress core translations.
+	 *
+	 * @since 2.8.0
+	 *
+	 * @param string $locale Current locale.
+	 */
+	$locale = apply_filters( 'core_version_check_locale', $locale );
 
 	// Update last_checked for current to prevent multiple blocking requests if request hangs
 	$current->last_checked = time();
@@ -212,14 +220,15 @@ function wp_update_plugins() {
 
 	$to_send = compact( 'plugins', 'active' );
 
+	$locales = array( get_locale() );
 	/**
 	 * Filter the locales requested for plugin translations.
 	 *
 	 * @since 3.7.0
 	 *
-	 * @param array $locales Defaults to the current locale of the site.
+	 * @param array $locales Plugin locale. Default is current locale of the site.
 	 */
-	$locales = apply_filters( 'plugins_update_check_locales', array( get_locale() ) );
+	$locales = apply_filters( 'plugins_update_check_locales', $locales );
 
 	$options = array(
 		'timeout' => ( ( defined('DOING_CRON') && DOING_CRON ) ? 30 : 3),
@@ -347,14 +356,15 @@ function wp_update_themes() {
 
 	$request['themes'] = $themes;
 
+	$locales = array( get_locale() );
 	/**
 	 * Filter the locales requested for theme translations.
 	 *
 	 * @since 3.7.0
 	 *
-	 * @param array $locales Defaults to the current locale of the site.
+	 * @param array $locales Theme locale. Default is current locale of the site.
 	 */
-	$locales = apply_filters( 'themes_update_check_locales', array( get_locale() ) );
+	$locales = apply_filters( 'themes_update_check_locales', $locales );
 
 	$options = array(
 		'timeout' => ( ( defined('DOING_CRON') && DOING_CRON ) ? 30 : 3),
@@ -443,7 +453,21 @@ function wp_get_update_data() {
 
 	$update_title = $titles ? esc_attr( implode( ', ', $titles ) ) : '';
 
-	return apply_filters( 'wp_get_update_data', array( 'counts' => $counts, 'title' => $update_title ), $titles );
+	$update_data = array( 'counts' => $counts, 'title' => $update_title );
+	/**
+	 * Filter the returned array of update data for plugins, themes, and WordPress core.
+	 *
+	 * @since 3.5.0
+	 *
+	 * @param array $update_data {
+	 *     Fetched update data.
+	 *
+	 *     @type array   $counts       An array of counts for available plugin, theme, and WordPress updates.
+	 *     @type string  $update_title Titles of available updates.
+	 * }
+	 * @param array $titles An array of update counts and UI strings for available updates.
+	 */
+	return apply_filters( 'wp_get_update_data', $update_data, $titles );
 }
 
 function _maybe_update_core() {