diff --git a/doc/adapter-api.txt b/doc/adapter-api.txt
index 62c7a27..36414d7 100644
--- a/doc/adapter-api.txt
+++ b/doc/adapter-api.txt
@@ -52,6 +52,13 @@ Properties	string Address [readonly]
 			The Bluetooth friendly name. This value can be
 			changed and a PropertyChanged signal will be emitted.
 
+			This property might be controlled by an external
+			daemon (for example hostnamed) and then every write
+			attempt will fail.
+
+			On a well configured system this property will be
+			automatically set to the pretty hostname.
+
 		uint32 Class [readonly]
 
 			The Bluetooth class of device.