[Telepathy-commits] [telepathy-spec/master] Connection_Interface_Contact_Capabilities.xml: Better introduction

[Alban Crequy]

---
 spec/Connection_Interface_Contact_Capabilities.xml |   17 +++++++++--------
 1 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/spec/Connection_Interface_Contact_Capabilities.xml b/spec/Connection_Interface_Contact_Capabilities.xml
index 3a8e7b0..22edfa3 100644
--- a/spec/Connection_Interface_Contact_Capabilities.xml
+++ b/spec/Connection_Interface_Contact_Capabilities.xml
@@ -22,19 +22,20 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     <tp:requires interface="org.freedesktop.Telepathy.Connection"/>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
-      <p>An interface for connections where it is possible to know what channel
-        classes may be created before the request is made to the connection
-        object. Each capability represents a commitment by the connection
-        manager that it will ordinarily be able to create a channel when given
-        a request with the properties defined by the channel class.</p>
+      <p>An interface to get contact capabilities in order to know what channel
+        classes may be created with a contact before the request is made to the
+        connection object. Each capability represents a commitment by the
+        connection manager that it will ordinarily be able to create a channel
+        with a contact when given a request with the properties defined by the
+        channel class.</p>
 
       <p>Capabilities pertain to particular contact handles, and represent
         activities such as having a text chat, a voice call with the user or a
         stream tube of a defined type.</p>
 
-      <p>This interface also provides for user interfaces notifying the
-        connection manager of what capabilities to advertise for the user. This
-        is done by using the SetSelfCapabilities method, and deals with
+      <p>This interface also enables user interfaces to notify the connection
+        manager what capabilities to advertise for the user to other contacts.
+        This is done by using the SetSelfCapabilities method, and deals with
         channel properties values pertaining to them which are implemented by
         available client processes.</p>
 
-- 
1.5.6.5