mgmt-api: Update comments for setting handling and errors

diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index a6bb22a..98e4707 100644 (file)
--- a/doc/mgmt-api.txt
+++ b/doc/mgmt-api.txt
@@ -128,6 +128,10 @@ Set Powered Command
        Command Parameters:     Powered (1 Octet)
        Return Parameters:      Current_Settings (4 Octets)
 
+       If discoverable setting is activated with a timeout, then
+       switching the controller off will expire this timeout and
+       disable discoverable.
+
        This command generates a Command Complete event on success or
        a Command Status event on failure.
 
@@ -141,7 +145,7 @@ Set Discoverable Command
                                Timeout (2 Octets)
        Return Parameters:      Current_Settings (4 Octets)
 
-       Timeout is the time in seconds and is only meningful when
+       Timeout is the time in seconds and is only meaningful when
        Discoverable is set to 1.
 
        This command can be used when the controller is not powered and
@@ -150,6 +154,9 @@ Set Discoverable Command
        However using a timeout when the controller is not powered will
        return an error.
 
+       When switching discoverable on and the connectable setting is
+       off it will return an error.
+
        This command generates a Command Complete event on success or
        a Command Status event on failure.
 
@@ -165,6 +172,13 @@ Set Connectable Command
        This command can be used when the controller is not powered and
        all settings will be programmed once powered.
 
+       When switching connectable off, it will also switch off the
+       discoverable setting. Once turned back on, it will restore the
+       value of discoverable setting (unless changed via Set Discoverable).
+
+       When switching connectable off it will expire a discoverable
+       setting with a timeout.
+
        This command generates a Command Complete event on success or
        a Command Status event on failure.
 
@@ -180,6 +194,8 @@ Set Fast Connectable Command
        This command can be used when the controller is not powered and
        all settings will be programmed once powered.
 
+       If connectable is not set, then this command will fail.
+
        This command generates a Command Complete event on success or
        a Command Status event on failure.
 
@@ -195,6 +211,11 @@ Set Pairable Command
        This command can be used when the controller is not powered and
        all settings will be programmed once powered.
 
+       Turning pairable on will not automatically switch the controller
+       into connectable mode. That needs to be done separately.
+
+       The setting will be remembered during power down/up toggles.
+
        This command generates a Command Complete event on success or
        a Command Status event on failure.