diff --git a/httpcore5/src/main/java/org/apache/hc/core5/reactor/IOSession.java b/httpcore5/src/main/java/org/apache/hc/core5/reactor/IOSession.java
index eaa318c5a..51c0aebeb 100644
--- a/httpcore5/src/main/java/org/apache/hc/core5/reactor/IOSession.java
+++ b/httpcore5/src/main/java/org/apache/hc/core5/reactor/IOSession.java
@@ -70,6 +70,7 @@ enum Status {
     /**
      * Returns event handler associated with the session.
      *
+     * @return the event handler, or {@code null} if no handler is associated with the session.
      * @since 5.0
      */
     IOEventHandler getHandler();
@@ -106,6 +107,7 @@ enum Status {
     /**
      * Removes first {@link Command} from the command queue if available.
      *
+     * @return the first command, or {@code null} if the queue is empty.
      * @since 5.0
      */
     Command poll();
@@ -120,14 +122,14 @@ enum Status {
     /**
      * Returns address of the remote peer.
      *
-     * @return socket address.
+     * @return socket address, or {@code null} if unavailable.
      */
     SocketAddress getRemoteAddress();
 
     /**
      * Returns local address.
      *
-     * @return socket address.
+     * @return socket address, or {@code null} if unavailable.
      */
     SocketAddress getLocalAddress();