ntwb / wordpress

src/wp-admin/includes/class-wp-site-icon.php

Doc Comments +2 added lines, -2 removed lines

@@ -221,11 +221,11 @@
 	 * @since 4.3.0
 	 * @access public
 	 *
-	 * @param null|array|string $value    The value get_metadata() should return a single metadata value, or an
+	 * @param string $value    The value get_metadata() should return a single metadata value, or an
 	 *                                    array of values.
 	 * @param int               $post_id  Post ID.
 	 * @param string            $meta_key Meta key.
-	 * @param string|array      $single   Meta value, or an array of values.
+	 * @param boolean      $single   Meta value, or an array of values.
 	 * @return array|null|string The attachment metadata value, array of values, or null.
 	 */
 	public function get_post_metadata( $value, $post_id, $meta_key, $single ) {

src/wp-admin/includes/class-wp-upgrader.php

Doc Comments +1 added lines, -1 removed lines

@@ -183,7 +183,7 @@
 	 *
 	 * @global WP_Filesystem_Base $wp_filesystem Subclass
 	 *
-	 * @param array $directories                  Optional. A list of directories. If any of these do
+	 * @param string[] $directories                  Optional. A list of directories. If any of these do
 	 *                                            not exist, a WP_Error object will be returned.
 	 *                                            Default empty array.
 	 * @param bool  $allow_relaxed_file_ownership Whether to allow relaxed file ownership.

src/wp-admin/includes/plugin.php

Doc Comments +5 added lines, -4 removed lines

@@ -188,7 +188,7 @@ 
  * @since 2.8.0
  *
  * @param string $plugin Path to the main plugin file from plugins directory.
- * @return array List of files relative to the plugin root.
+ * @return string[] List of files relative to the plugin root.
  */
 function get_plugin_files($plugin) {
 	$plugin_file = WP_PLUGIN_DIR . '/' . $plugin;
@@ -638,7 +638,7 @@ 
  *
  * @param string|array $plugins Single plugin or list of plugins to deactivate.
  * @param bool $silent Prevent calling deactivation hooks. Default is false.
- * @param mixed $network_wide Whether to deactivate the plugin for all sites in the network.
+ * @param boolean $network_wide Whether to deactivate the plugin for all sites in the network.
  * 	A value of null (the default) will deactivate plugins for both the site and the network.
  */
 function deactivate_plugins( $plugins, $silent = false, $network_wide = null ) {
@@ -767,7 +767,7 @@ 
  *
  * @global WP_Filesystem_Base $wp_filesystem
  *
- * @param array  $plugins    List of plugins to delete.
+ * @param string[]  $plugins    List of plugins to delete.
  * @param string $deprecated Deprecated.
  * @return bool|null|WP_Error True on success, false is $plugins is empty, WP_Error on failure.
  *                            Null if filesystem credentials are required to proceed.
@@ -985,7 +985,7 @@ 
  * @since 2.7.0
  *
  * @param string $plugin Path to the main plugin file from plugins directory.
- * @return true True if a plugin's uninstall.php file has been found and included.
+ * @return boolean|null True if a plugin's uninstall.php file has been found and included.
  */
 function uninstall_plugin($plugin) {
 	$file = plugin_basename($plugin);
@@ -1505,6 +1505,7 @@ 
  * @global array $_wp_real_parent_file
  * @global array $_wp_menu_nopriv
  * @global array $_wp_submenu_nopriv
+ * @return string
  */
 function get_admin_page_parent( $parent = '' ) {
 	global $parent_file, $menu, $submenu, $pagenow, $typenow,

src/wp-admin/includes/taxonomy.php

Doc Comments +1 added lines, -1 removed lines

@@ -193,7 +193,7 @@
  *
  * @since 2.3.0
  *
- * @param int|string $tag_name
+ * @param string $tag_name
  * @return mixed
  */
 function tag_exists($tag_name) {

src/wp-admin/includes/user.php

Doc Comments +1 added lines, -1 removed lines

@@ -11,7 +11,7 @@
  *
  * @since 2.0.0
  *
- * @return int|WP_Error WP_Error or User ID.
+ * @return integer WP_Error or User ID.
  */
 function add_user() {
 	return edit_user();

src/wp-includes/cache.php

Doc Comments +8 added lines, -8 removed lines

@@ -41,7 +41,7 @@ 
  *
  * @since 2.0.0
  *
- * @return true Always returns true.
+ * @return boolean Always returns true.
  */
 function wp_cache_close() {
 	return true;
@@ -55,7 +55,7 @@ 
  * @see WP_Object_Cache::decr()
  * @global WP_Object_Cache $wp_object_cache Object cache global instance.
  *
- * @param int|string $key    The cache key to decrement.
+ * @param string $key    The cache key to decrement.
  * @param int        $offset Optional. The amount by which to decrement the item's value. Default 1.
  * @param string     $group  Optional. The group the key is in. Default empty.
  * @return false|int False on failure, the item's new value on success.
@@ -131,7 +131,7 @@ 
  * @see WP_Object_Cache::incr()
  * @global WP_Object_Cache $wp_object_cache Object cache global instance.
  *
- * @param int|string $key    The key for the cache contents that should be incremented.
+ * @param string $key    The key for the cache contents that should be incremented.
  * @param int        $offset Optional. The amount by which to increment the item's value. Default 1.
  * @param string     $group  Optional. The group the key is in. Default empty.
  * @return false|int False on failure, the item's new value on success.
@@ -161,8 +161,8 @@ 
  * @see WP_Object_Cache::replace()
  * @global WP_Object_Cache $wp_object_cache Object cache global instance.
  *
- * @param int|string $key    The key for the cache data that should be replaced.
- * @param mixed      $data   The new data to store in the cache.
+ * @param string $key    The key for the cache data that should be replaced.
+ * @param string      $data   The new data to store in the cache.
  * @param string     $group  Optional. The group for the cache data that should be replaced.
  *                           Default empty.
  * @param int        $expire Optional. When to expire the cache contents, in seconds.
@@ -510,7 +510,7 @@ 
 	 * @since 2.0.0
 	 * @access public
 	 *
-	 * @return true Always returns true.
+	 * @return boolean Always returns true.
 	 */
 	public function flush() {
 		$this->cache = array();
@@ -659,7 +659,7 @@ 
 	 * @param mixed      $data   The contents to store in the cache.
 	 * @param string     $group  Optional. Where to group the cache contents. Default 'default'.
 	 * @param int        $expire Not Used.
-	 * @return true Always returns true.
+	 * @return boolean Always returns true.
 	 */
 	public function set( $key, $data, $group = 'default', $expire = 0 ) {
 		if ( empty( $group ) )
@@ -749,7 +749,7 @@ 
 	 *
 	 * @since 2.0.8
 	 *
-	 * @return true Always returns true.
+	 * @return boolean Always returns true.
 	 */
 	public function __destruct() {
 		return true;

src/wp-includes/category-template.php

Doc Comments +2 added lines, -2 removed lines

@@ -663,7 +663,7 @@ 
  * @since 4.8.0 Added the `show_count` argument.
  *
  * @param array|string|null $args Optional. Override default arguments.
- * @return void|array Generated tag cloud, only if no failures and 'array' is set for the 'format' argument.
+ * @return string Generated tag cloud, only if no failures and 'array' is set for the 'format' argument.
  *                    Otherwise, this function outputs the tag cloud.
  */
 function wp_tag_cloud( $args = '' ) {
@@ -716,7 +716,7 @@ 
  * @since 2.9.0
  *
  * @param int $count Number of posts with that tag.
- * @return int Scaled count.
+ * @return double Scaled count.
  */
 function default_topic_count_scale( $count ) {
 	return round(log10($count + 1) * 100);

src/wp-includes/class-wp-customize-nav-menus.php

Doc Comments +3 added lines, -3 removed lines

@@ -42,7 +42,7 @@ 
 	 * @since 4.3.0
 	 * @access public
 	 *
-	 * @param object $manager An instance of the WP_Customize_Manager class.
+	 * @param WP_Customize_Manager $manager An instance of the WP_Customize_Manager class.
 	 */
 	public function __construct( $manager ) {
 		$this->previewed_menus = array();
@@ -482,7 +482,7 @@ 
 	 * @since 4.3.0
 	 * @access public
 	 *
-	 * @param false|array $setting_args The arguments to the WP_Customize_Setting constructor.
+	 * @param WP_Customize_Manager $setting_args The arguments to the WP_Customize_Setting constructor.
 	 * @param string      $setting_id   ID for dynamic setting, usually coming from `$_POST['customized']`.
 	 * @return array|false
 	 */
@@ -1291,7 +1291,7 @@ 
 	 *
 	 * @param string $nav_menu_content The HTML content for the navigation menu.
 	 * @param object $args             An object containing wp_nav_menu() arguments.
-	 * @return null
+	 * @return string
 	 */
 	public function filter_wp_nav_menu( $nav_menu_content, $args ) {
 		if ( isset( $args->customize_preview_nav_menus_args['can_partial_refresh'] ) && $args->customize_preview_nav_menus_args['can_partial_refresh'] ) {

src/wp-includes/class-wp-dependency.php

Doc Comments +1 added lines, -1 removed lines

@@ -91,7 +91,7 @@
 	 * @since 2.6.0
 	 *
 	 * @param string $name The data key to add.
-	 * @param mixed  $data The data value to add.
+	 * @param integer  $data The data value to add.
 	 * @return bool False if not scalar, true otherwise.
 	 */
 	public function add_data( $name, $data ) {