api: clarify lifetime and behavior of ActiveConnection's SpecificObject property (rh #1012309)

It doesn't change once it's set, and it reflects the original
specific object used during activation.  It will not, for example,
switch to the currently active WiFi access point even if the
original access point that was used as the specific object disappears.
This commit is contained in:
Dan Williams 2013-09-26 12:15:11 -05:00
parent f820fbeeb3
commit a045c29638

View file

@ -14,7 +14,11 @@
<tp:docstring>The path of the connection.</tp:docstring>
</property>
<property name="SpecificObject" type="o" access="read">
<tp:docstring>A specific object associated with the active connection.</tp:docstring>
<tp:docstring>
A specific object associated with the active connection. This property
reflects the specific object used during connection activation, and will
not change over the lifetime of the ActiveConnection once set.
</tp:docstring>
</property>
<property name="Uuid" type="s" access="read">
<tp:docstring>