diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index fed41a9..6d411f4 100644
--- a/doc/mgmt-api.txt
+++ b/doc/mgmt-api.txt
@@ -1820,7 +1820,7 @@ Get Connection Information Command
 		2	LE Random
 
 	TX_Power and Max_TX_Power can be set to 127 if values are invalid or
-	unknown.
+	unknown. A value of 127 for RSSI indicates that it is not available.
 
 	This command generates a Command Complete event on success and
 	on failure. In case of failure only Address and Address_Type fields
@@ -2609,6 +2609,10 @@ Device Found Event
 		1	Legacy Pairing
 		2	Not Connectable
 
+	For the RSSI field a value of 127 indicates that the RSSI is
+	not available. That can happen with Bluetooth 1.1 and earlier
+	controllers or with bad radio conditions.
+
 	The Confirm name flag indicates that the kernel wants to know
 	whether user space knows the name for this device or not. If
 	this flag is set user space should respond to it using the