From e56f0ea18f77f529ed6ee9cbeb28c9a5aed155b9 Mon Sep 17 00:00:00 2001
From: Dan Williams <dcbw@redhat.com>
Date: Thu, 26 May 2011 17:46:41 -0500
Subject: [PATCH] api: update some documentation for Connection.Active

---
 introspection/nm-active-connection.xml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/introspection/nm-active-connection.xml b/introspection/nm-active-connection.xml
index 1594764eec..a150b2c829 100644
--- a/introspection/nm-active-connection.xml
+++ b/introspection/nm-active-connection.xml
@@ -2,6 +2,14 @@
 
 <node name="/" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
   <interface name="org.freedesktop.NetworkManager.Connection.Active">
+    <tp:docstring>
+      Objects that implement the Connection.Active interface represent an attempt
+      to connect to a network using the details provided by a Connection object.
+      The Connection.Active object tracks the life-cycle of the connection
+      attempt and if successful indicates whether the connected network is the
+      "default" or preferred network for access.
+    </tp:docstring>
+
     <property name="Connection" type="o" access="read">
       <tp:docstring>The path of the connection.</tp:docstring>
     </property>