Index: plugin-install.php
===================================================================
--- plugin-install.php	(revision 38042)
+++ plugin-install.php	(working copy)
@@ -356,8 +356,14 @@
  * @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 is false
+ * @return type array set of 'status', 'url', 'version', 'file'  
+ *   Array ( 
+ *	     [status] => ''
+ *	     [url] => '' 
+ *	     [version] => ''
+ *	     [file] => ''
+ *         ); 
  */
 function install_plugin_install_status($api, $loop = false) {
 	// This function is called recursively, $loop prevents further loops.
@@ -364,7 +370,7 @@
 	if ( is_array($api) )
 		$api = (object) $api;
 
-	// Default to a "new" plugin
+	// Default to a "new" plugin 
 	$status = 'install';
 	$url = false;
 	$update_file = false;