diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index 0a95a0e..e5f9ff3 100644
--- a/doc/mgmt-api.txt
+++ b/doc/mgmt-api.txt
@@ -1411,6 +1411,15 @@ Block Device Command
 		1	LE Public
 		2	LE Random
 
+	For Low Energy devices, the blocking of a device take presedence
+	over auto-connection actions provided by Add Device. Blocked
+	devices will not be auto-connected or even reported when found
+	during background scanning. If the controller is connectable
+	direct advertising from blocked devices will also be ignored.
+
+	Connections created from advertising of the controller will
+	be dropped if the device is blocked.
+
 	This command can be used when the controller is not powered.
 
 	This command generates a Command Complete event on success
@@ -1439,6 +1448,9 @@ Unblock Device Command
 		1	LE Public
 		2	LE Random
 
+	When the Address parameter is 00:00:00:00:00:00, then all
+	previously blocked devices will be unblocked.
+
 	This command can be used when the controller is not powered.
 
 	This command generates a Command Complete event on success
@@ -1874,6 +1886,10 @@ Add Device Command
 	then devices using undirected advertising will only connect when
 	using Action 1 or Action 2.
 
+	When a device is blocked using Block Device command, then it is
+	valid to add the device here, but all actions will be ignored
+	until the device is unblocked.
+
 	This command can be used when the controller is not powered and
 	all settings will be programmed once powered.
 
@@ -1904,7 +1920,7 @@ Remove Device Command
 		2	LE Random
 
 	When the Address parameter is 00:00:00:00:00:00, then all
-	previously added devices wil be removed.
+	previously added devices will be removed.
 
 	This command can be used when the controller is not powered and
 	all settings will be programmed once powered.