From 240480486770b0b2d487e3be38ab3c1f1ee1e048 Mon Sep 17 00:00:00 2001
From: kenjis <kenji.uui@gmail.com>
Date: Mon, 17 Oct 2022 11:03:45 +0900
Subject: [PATCH] docs: add comments

---
 system/HTTP/Message.php                  | 4 ++++
 system/HTTP/OutgoingRequestInterface.php | 2 ++
 system/HTTP/RequestInterface.php         | 2 ++
 3 files changed, 8 insertions(+)

diff --git a/system/HTTP/Message.php b/system/HTTP/Message.php
index 34181d5aec60..01496d780c1a 100644
--- a/system/HTTP/Message.php
+++ b/system/HTTP/Message.php
@@ -61,6 +61,8 @@ public function getBody()
      *
      * @deprecated Use Message::headers() to make room for PSR-7
      *
+     * @TODO Incompatible return value with PSR-7
+     *
      * @codeCoverageIgnore
      */
     public function getHeaders(): array
@@ -76,6 +78,8 @@ public function getHeaders(): array
      *
      * @deprecated Use Message::header() to make room for PSR-7
      *
+     * @TODO Incompatible return value with PSR-7
+     *
      * @codeCoverageIgnore
      */
     public function getHeader(string $name)
diff --git a/system/HTTP/OutgoingRequestInterface.php b/system/HTTP/OutgoingRequestInterface.php
index 8c5493373054..3839b64fd8e1 100644
--- a/system/HTTP/OutgoingRequestInterface.php
+++ b/system/HTTP/OutgoingRequestInterface.php
@@ -15,6 +15,8 @@
 
 /**
  * Representation of an outgoing, client-side request.
+ *
+ * Corresponds to Psr7\RequestInterface.
  */
 interface OutgoingRequestInterface extends MessageInterface
 {
diff --git a/system/HTTP/RequestInterface.php b/system/HTTP/RequestInterface.php
index a06b4c6c774d..fd2cdfbbc949 100644
--- a/system/HTTP/RequestInterface.php
+++ b/system/HTTP/RequestInterface.php
@@ -13,6 +13,8 @@
 
 /**
  * Representation of an incoming, server-side HTTP request.
+ *
+ * Corresponds to Psr7\ServerRequestInterface.
  */
 interface RequestInterface extends OutgoingRequestInterface
 {