Ticket #36912: 36912.3.patch

wp-admin/includes/plugin-install.php

@@ -348 +348 @@
  *
  * @since 3.0.0
  *
- * @param array|object $api
- * @param bool        $loop
- * @return type
+ * @param  array|object $api  Data about the plugin retrieved from the API.
+ * @param  bool         $loop Optional. Disable further loops. Default False.
+ * @return array        {
+ *
+ *     @type string $status    Status of a plugin. Could be one of Install, Update Available, 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.