Docs: Add missing inline documentation in `WP_HTTP_Requests_Response`.

* Adds a missing file header
* Adjusts class DocBlock
* Adds missing version and access information for all methods

See #37318, [37428] and #33055.

Built from https://develop.svn.wordpress.org/trunk@38120


git-svn-id: http://core.svn.wordpress.org/trunk@38061 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-includes/class-wp-http-requests-response.php

@@ -1,16 +1,25 @@
 <?php
-
 /**
- * Wrapper object for a Requests_Response for standardisation.
+ * HTTP API: WP_HTTP_Requests_Response class
  *
  * @package WordPress
  * @subpackage HTTP
  * @since 4.6.0
  */
+
+/**
+ * Core wrapper object for a Requests_Response for standardisation.
+ *
+ * @since 4.6.0
+ *
+ * @see WP_HTTP_Response
+ */
 class WP_HTTP_Requests_Response extends WP_HTTP_Response {
 	/**
 	 * Requests Response object.
 	 *
+	 * @since 4.6.0
+	 * @access protected
 	 * @var Requests_Response
 	 */
 	protected $response;
@@ -18,12 +27,20 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
 	/**
 	 * Filename the response was saved to.
 	 *
+	 * @since 4.6.0
+	 * @access protected
 	 * @var string|null
 	 */
 	protected $filename;
 
 	/**
 	 * Constructor.
+	 *
+	 * @since 4.6.0
+	 * @access public
+	 *
+	 * @param Requests_Response $response HTTP response.
+	 * @param string            $filename Optional. File name. Default empty.
 	 */
 	public function __construct( Requests_Response $response, $filename = '' ) {
 		$this->response = $response;
@@ -31,9 +48,12 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
 	}
 
 	/**
-	 * Get the response object for the request.
+	 * Retrieves the response object for the request.
 	 *
-	 * @return Requests_Response
+	 * @since 4.6.0
+	 * @access public
+	 *
+	 * @return Requests_Response HTTP response.
 	 */
 	public function get_response_object() {
 		return $this->response;
@@ -42,6 +62,9 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
 	/**
 	 * Retrieves headers associated with the response.
 	 *
+	 * @since 4.6.0
+	 * @access public
+	 *
 	 * @return array Map of header name to header value.
 	 */
 	public function get_headers() {
@@ -63,6 +86,9 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
 	/**
 	 * Sets all header values.
 	 *
+	 * @since 4.6.0
+	 * @access public
+	 *
 	 * @param array $headers Map of header name to header value.
 	 */
 	public function set_headers( $headers ) {
@@ -72,6 +98,9 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
 	/**
 	 * Sets a single HTTP header.
 	 *
+	 * @since 4.6.0
+	 * @access public
+	 *
 	 * @param string $key     Header name.
 	 * @param string $value   Header value.
 	 * @param bool   $replace Optional. Whether to replace an existing header of the same name.
@@ -88,6 +117,9 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
 	/**
 	 * Retrieves the HTTP return code for the response.
 	 *
+	 * @since 4.6.0
+	 * @access public
+	 *
 	 * @return int The 3-digit HTTP status code.
 	 */
 	public function get_status() {
@@ -97,6 +129,9 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
 	/**
 	 * Sets the 3-digit HTTP status code.
 	 *
+	 * @since 4.6.0
+	 * @access public
+	 *
 	 * @param int $code HTTP status.
 	 */
 	public function set_status( $code ) {
@@ -106,6 +141,9 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
 	/**
 	 * Retrieves the response data.
 	 *
+	 * @since 4.6.0
+	 * @access public
+	 *
 	 * @return mixed Response data.
 	 */
 	public function get_data() {
@@ -115,6 +153,9 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
 	/**
 	 * Sets the response data.
 	 *
+	 * @since 4.6.0
+	 * @access public
+	 *
 	 * @param mixed $data Response data.
 	 */
 	public function set_data( $data ) {
@@ -122,7 +163,10 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
 	}
 
 	/**
-	 * Get cookies from the response.
+	 * Retrieves cookies from the response.
+	 *
+	 * @since 4.6.0
+	 * @access public
 	 *
 	 * @return WP_HTTP_Cookie[] List of cookie objects.
 	 */
@@ -142,7 +186,10 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
 	}
 
 	/**
-	 * Convert the object to a WP_Http response array.
+	 * Converts the object to a WP_Http response array.
+	 *
+	 * @since 4.6.0
+	 * @access public
 	 *
 	 * @return array WP_Http response array, per WP_Http::request().
 	 */

wp-includes/version.php

@@ -4,7 +4,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '4.6-beta3-38119';
+$wp_version = '4.6-beta3-38120';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.