diff --git a/doc/zmq_msg_gets.txt b/doc/zmq_msg_gets.txt
index b909092b..778bd95d 100644
--- a/doc/zmq_msg_gets.txt
+++ b/doc/zmq_msg_gets.txt
@@ -28,7 +28,10 @@ function:
     Socket-Type
     Identity
     Resource
-    Peer-Address
+
+Additionally, when available for the underlying transport, the *Peer-Address*
+property will return the IP address of the remote endpoint as returned by
+getnameinfo(2).
 
 Other properties may be defined based on the underlying security, see ZAP
 auththenticated connection sample below.