--- a/ipcm_pub/connection_settings_api/inc/cmdestination.h	Wed Oct 27 17:43:56 2010 +0300
+++ b/ipcm_pub/connection_settings_api/inc/cmdestination.h	Wed Oct 27 17:51:11 2010 +0300
@@ -201,6 +201,10 @@
 
         /**
         * Embeds an existing destination into this destination.
+        * A destination can only hold one embedded destination.
+        * Trying to add a second one will fail with KErrNotSupported.
+        * Also, an already embedded destination can't contain an embedded
+        * destination itself, preventing chains of three destinations or more.
         * @param RCmDestination - Destination to be embedded
         * @return TInt - index in the Connection Method list
         */