[telepathy-spec/master] Add a signal to indicate if the nat server info has been retrieved

[Sjoerd Simons]

Farsight currently needs both the stun and relay info to be set before it can
start doing anything with a stream. Hopefully in the future this will change.
But for now having seperate StunServerAdded and RelayInfoAdded signals are
pointless.

When farsight is eventually updated to be able to add stun and relay servers on
the fly, this signal is still needed as we need to be able to tell some
protocols that we have an initial set of candidates, which needs to wait for an
initial set of stun server and relay servers to have been retrieved.
---
 spec/Call_Stream_Interface_Media.xml |   29 ++++++++++++++++++-----------
 1 files changed, 18 insertions(+), 11 deletions(-)

diff --git a/spec/Call_Stream_Interface_Media.xml b/spec/Call_Stream_Interface_Media.xml
index 2df580a..8bdb05d 100644
--- a/spec/Call_Stream_Interface_Media.xml
+++ b/spec/Call_Stream_Interface_Media.xml
@@ -132,12 +132,6 @@
       <arg name="password" type="s" />
     </signal>
 
-    <signal name="STUNServersAdded"
-        tp:name-for-bindings="STUN_Servers_Added">
-      <arg name="servers"
-      type="a(sq)" tp:type="Socket_Address_IP[]"/>
-    </signal>
-
     <property name="STUNServers" tp:name-for-bindings="STUN_Servers"
       type="a(sq)" tp:type="Socket_Address_IP[]" access="read">
       <tp:docstring>
@@ -155,11 +149,6 @@
       </tp:docstring>
     </property>
 
-    <signal name="RelayInfoAdded" tp:name-for-bindings="Relay_Info_Added">
-      <arg name="relay_info"
-        type="aa{sv}" tp:type="String_Variant_Map[]"/>
-    </signal>
-
     <property name="RelayInfo" type="aa{sv}" access="read"
       tp:type="String_Variant_Map[]" tp:name-for-bindings="Relay_Info">
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
@@ -233,6 +222,24 @@
       </tp:docstring>
     </property>
 
+    <signal name="ServerInfoRetrieved"
+      tp:name-for-bindings="Server_Info_Retrieved">
+      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+        <p> Signals that the initial information about STUN and Relay servers
+            has been retrieived.
+        </p>
+      </tp:docstring>
+    </signal>
+
+    <property name="RetrievedServerInfo" type="boolean"
+        tp:name-for-bindings="Retrieved_Server_Info" access="read">
+      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+        <p>True if the initial information about STUN servers and Relay servers
+           has been retrieved.
+        </p>
+      </tp:docstring>
+    </property>
+
     <signal name="EndpointsChanged"
         tp:name-for-bindings="Endpoints_Changed">
       <arg name="EndpointsAdded" type="ao" />
-- 
1.5.6.5