phpdoc for the new method

Author: dbu

Diff for: src/Formatter.php

@@ -10,6 +10,9 @@
  *
  * @author Márk Sági-Kazár <[email protected]>
  *
+ * The formatResponseForRequest method will be added to this interface in the next major version, replacing the formatRequest method.
+ * Meanwhile, callers SHOULD check the formatter for the existence of formatResponseForRequest and call that if available.
+ *
  * @method string formatResponseForRequest(ResponseInterface $response, RequestInterface $request) Formats a response in context of its request.
  */
 interface Formatter

Diff for: src/Formatter/CurlCommandFormatter.php

@@ -69,7 +69,9 @@ public function formatResponse(ResponseInterface $response)
     }
 
     /**
-     * {@inheritdoc}
+     * Formats a response in context of its request.
+     *
+     * @return string
      */
     public function formatResponseForRequest(ResponseInterface $response, RequestInterface $request)
     {

Diff for: src/Formatter/FullHttpMessageFormatter.php

@@ -75,7 +75,9 @@ public function formatResponse(ResponseInterface $response)
     }
 
     /**
-     * {@inheritdoc}
+     * Formats a response in context of its request.
+     *
+     * @return string
      */
     public function formatResponseForRequest(ResponseInterface $response, RequestInterface $request)
     {

Diff for: src/Formatter/SimpleFormatter.php

@@ -41,7 +41,9 @@ public function formatResponse(ResponseInterface $response)
     }
 
     /**
-     * {@inheritdoc}
+     * Formats a response in context of its request.
+     *
+     * @return string
      */
     public function formatResponseForRequest(ResponseInterface $response, RequestInterface $request)
     {