Index: wp-admin/includes/plugin-install.php
===================================================================
--- wp-admin/includes/plugin-install.php	(revision 38701)
+++ wp-admin/includes/plugin-install.php	(working copy)
@@ -348,9 +348,17 @@
  *
  * @since 3.0.0
  *
- * @param array|object $api
- * @param bool        $loop
- * @return type
+ * @param  array|object $api  Date about the plugin.
+ * @param  bool         $loop (Optional) Disable further loops, False by default.
+ * @return array        {
+ *
+ *     @type string $status    Status of a plugin. Install or Update Available or Latest Installed or Newer Installed
+ *     @type string $url       Plugin installation URL.
+ *     @type int    $version   The version of Plugin.
+ *     @type string $file      Plugin filename relative to the plugins directory.
+ *
+ * }
+ *
  */
 function install_plugin_install_status($api, $loop = false) {
 	// This function is called recursively, $loop prevents further loops.