Index: src/wp-includes/class-requests.php
===================================================================
--- src/wp-includes/class-requests.php	(revision 46615)
+++ src/wp-includes/class-requests.php	(working copy)
@@ -421,10 +421,56 @@
 	 *    (callback)
 	 *
 	 * @param array $requests Requests data (see description for more information)
-	 * @param array $options Global and default options (see {@see Requests::request})
-	 * @return array Responses (either Requests_Response or a Requests_Exception object)
+	 * @param array $options {
+	 *     Global and default options (see {@see Requests::request})
+	 *
+	 *     @type float $timeout                            How long should we wait for a response?
+	 *                                                     Note: for cURL, a minimum of 1 second applies, as DNS resolution
+	 *                                                     operates at second-resolution only.
+	 *                                                     (float, seconds with a millisecond precision, default: 10, example: 0.01)
+	 *    @type float $connect_timeout                     How long should we wait while trying to connect?
+	 *                                                     (float, seconds with a millisecond precision, default: 10, example: 0.01)
+	 *    @type string $useragent                          Useragent to send to the server
+	 *                                                     (string, default: php-requests/$version)
+	 *    @type string $follow_redirects                   Should we follow 3xx redirects?
+	 *                                                     (boolean, default: true)
+	 *    @type integer $redirects                         How many times should we redirect before erroring?
+	 *                                                     (integer, default: 10)
+	 *    @type integer $blocking                          Should we block processing on this request?
+	 *                                                     (boolean, default: true)
+	 *    @type string|boolean $filename                   File to stream the body to instead.
+	 *                                                     (string|boolean, default: false)
+	 *    @type Requests_Auth|array|boolean $auth          Authentication handler or array of user/password details to use
+	 *                                                     for Basic authentication
+	 *                                                     (Requests_Auth|array|boolean, default: false)
+	 *    @type Requests_Proxy|array|string|boolean $proxy Proxy details to use for proxy by-passing and authentication
+	 *                                                     (Requests_Proxy|array|string|boolean, default: false)
+	 *    @type integer|boolean $max_bytes                 Limit for the response body size.
+	 *                                                     (integer|boolean, default: false)
+	 *    @type boolean $idn                               Enable IDN parsing
+	 *                                                     (boolean, default: true)
+	 *    @type string|Requests_Transport $transport       Custom transport. Either a class name, or a
+	 *                                                     transport object. Defaults to the first working transport from
+	 *                                                     {@see getTransport()}
+	 *                                                     (string|Requests_Transport, default: {@see getTransport()})
+	 *    @type Requests_Hooker $hooks                     Hooks handler.
+	 *                                                     (Requests_Hooker, default: new Requests_Hooks())
+	 *    @type string|boolean $verify                     Should we verify SSL certificates? Allows passing in a custom
+	 *                                                     certificate file as a string. (Using true uses the system-wide root
+	 *                                                     certificate store instead, but this may have different behaviour
+	 *                                                     across transports.)
+	 *                                                     (string|boolean, default: library/Requests/Transport/cacert.pem)
+	 *    @type boolean $verifyname                        Should we verify the common name in the SSL certificate?
+	 *                                                     (boolean: default, true)
+	 *    @type string $data_format                        How should we send the `$data` parameter?
+	 *                                                     (string, one of 'query' or 'body', default: 'query' for
+	 *                                                     HEAD/GET/DELETE, 'body' for POST/PUT/OPTIONS/PATCH)
+	 * }
+	 * @return Requests_Response[]|Requests_Exception[] Responses (either Requests_Response or a Requests_Exception object)
+	 * @throws Requests_Exception
 	 */
 	public static function request_multiple($requests, $options = array()) {
+		var_dump($options); exit;
 		$options = array_merge(self::get_default_options(true), $options);
 
 		if (!empty($options['hooks'])) {