[#2521] DBUS-XML API documentation

sflphone-common/src/dbus/instance-introspec.xml

 <?xml version="1.0" ?>
-<node name="/org/sflphone/SFLphone">
+<node name="/instance-introspec" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
 	<interface name="org.sflphone.SFLphone.Instance">
-  
-    <method name="Register">
-      <arg type="i" name="pid" direction="in"/>
-      <arg type="s" name="name" direction="in"/>
+		<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+		<p>Instances Manager to handle multiple client connections to the core.</p>
+		</tp:docstring>
+		<method name="Register" tp:name-for-bindings="Register">
+			<tp:docstring>
+				Register a new client to the core. Increments the registration count.
+			</tp:docstring>
+			<arg type="i" name="pid" direction="in">
+				<tp:docstring>
+					The pid of the client process
+				</tp:docstring>
+			</arg>
+			<arg type="s" name="name" direction="in">
+				<tp:docstring>
+					The name of the client
+				</tp:docstring>
+			</arg>
 		</method>
-    
-    <method name="Unregister">
-      <arg type="i" name="pid" direction="in"/>
+		<method name="Unregister" tp:name-for-bindings="Unregister">
+			<tp:docstring>
+				Unregister a connected client from the core. Decrements the registration count. If no more clients are connected, ie the registration count equals 0, the core properly quits.
+			</tp:docstring>
+			<arg type="i" name="pid" direction="in">
+				<tp:docstring>
+					The pid of the client process
+				</tp:docstring>
+			</arg>
 		</method>
 
-    <method name="getRegistrationCount">
-      <arg type="i" name="count" direction="out"/>
+		<method name="getRegistrationCount" tp:name-for-bindings="getRegistrationCount">
+			<tp:docstring>
+				Get the number of connected clients.
+			</tp:docstring>
+		      <arg type="i" name="count" direction="out">
+				<tp:docstring>
+					The number of client currently connected to the core
+				</tp:docstring>
+				</arg>
 		</method>
+
+
     </interface>
 </node>