[Telepathy-commits] [telepathy-spec/master] Document that Observers are notified about all new channels, regardless of direction

[Simon McVittie]

20080625120546-53eee-7d8eafd640659249f5a6cfc04b651a5276fd2a4c.gz
---
 spec/Client_Observer.xml |   13 +++++++++++--
 1 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/spec/Client_Observer.xml b/spec/Client_Observer.xml
index f598644..051e010 100644
--- a/spec/Client_Observer.xml
+++ b/spec/Client_Observer.xml
@@ -32,9 +32,18 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
         alter the state of the channel.</p>
 
       <p>Whenever a new channel is signalled, the channel dispatcher
-        notifies all observers whose
+        notifies all running or activatable observers whose
         <tp:member-ref>ObserverChannelFilter</tp:member-ref> property
-        indicates that they are interested in the channel.</p>
+        (possibly as cached in the .client file) indicates that they are
+        interested in the channel.</p>
+
+      <p>Observers are activated for all channels in which they have
+        registered an interest - incoming, outgoing or automatically created -
+        although of course the ObserverChannelFilter property can be set
+        to filter on the
+        <tp:dbus-ref
+          namespace="org.freedesktop.Telepathy.Channel.FUTURE">Direction</tp:dbus-ref>
+        property.</p>
     </tp:docstring>
 
     <property name="ObserverChannelFilter" type="v">
-- 
1.5.6.5