doc: Add comments on how blocked devices interact with auto-connection

diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index 0a95a0e..e5f9ff3 100644 (file)
--- 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.