Index: plugin-install.php
===================================================================
--- plugin-install.php	(revision 38065)
+++ plugin-install.php	(working copy)
@@ -356,8 +356,16 @@
  * @since 3.0.0
  *
  * @param array|object $api
- * @param bool        $loop
- * @return type
+ * @param bool  $loop is optional constant specify the true or false. Default false.
+ * @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.