Initial documentation of presence service overview.

Fix weird indent in server_plugin module

2 files changed, 37 insertions, 1 deletions

diff --git a/services/presence/__init__.py b/services/presence/__init__.py
index e69de29..bd64375 100644
--- a/services/presence/__init__.py
+++ b/services/presence/__init__.py
@@ -0,0 +1,36 @@
+"""Service to track buddies and activities on the network
+
+Model objects:
+
+    activity.Activity -- tracks a (shared/shareable) activity
+        with many properties and observable events
+    
+    buddy.Buddy -- tracks a reference to a particular actor
+        on the network
+        
+        buddy.GenericOwner -- actor who owns a particular 
+            activity on the network 
+        
+        buddy.ShellOwner -- actor who owns the local machine
+            connects to the owner module (on the server)
+    
+Controller objects:
+
+    presenceservice.PresenceService -- controller which connects 
+        a networking plugin to a DBUS service.  Generates events 
+        for networking events, forwards updates/requests to the 
+        server plugin.
+    
+    server_plugin.ServerPlugin -- implementation of networking 
+        plugin using telepathy Python (Jabber) to provide the 
+        underlying communications layer.  Generates GObject 
+        events that the PresenceService observes to forward onto 
+        the DBUS clients.
+
+Utility machinery:
+
+    buddyiconcache.BuddyIconCache -- caches buddy icons on disk
+        based on the "jid" XXX Jabber ID? of the buddy.
+    
+    psutils -- trivial function to decode int-list to characters
+"""
diff --git a/services/presence/server_plugin.py b/services/presence/server_plugin.py
index 268552c..3cd078b 100644
--- a/services/presence/server_plugin.py
+++ b/services/presence/server_plugin.py
@@ -548,7 +548,7 @@ class ServerPlugin(gobject.GObject):
             # are handled locally
             return
         if self._online_contacts.has_key(handle) and self._online_contacts[handle]:
-	        self.emit("buddy-properties-changed", handle, properties)
+            self.emit("buddy-properties-changed", handle, properties)
 
     def _buddy_activities_changed_cb(self, handle, activities):
         if handle == self._conn[CONN_INTERFACE].GetSelfHandle():