session: Update AllowedBearers documentation

diff --git a/doc/session-api.txt b/doc/session-api.txt
index 14ff76b..aab7a9a 100644 (file)
--- a/doc/session-api.txt
+++ b/doc/session-api.txt
@@ -141,9 +141,18 @@ Settings   boolean State [readonly]
                        entries in this list.
 
                        Also "*" matches any bearer. This is usefull to prefer
-                       certain bearers such as Wifi with a fallback to any
+                       certain bearers such as 'wifi' with a fallback to any
                        other available bearer.
 
+                       Invalid bearer names will be ignored and removed
+                       from the list. And empty AllowedBearers will
+                       not match to any bearer, therefore the session
+                       will never go online.
+
+                       When a session is created and the provided settings
+                       dictionary does not contain AllowedBearers, a default
+                       session with "*" will be created.
+
                string ConnectionType [readwrite]
 
                        This is used to indicate which connection is requested