From 79d17c14f4e1321c2311c4800d36b1da19653eda Mon Sep 17 00:00:00 2001
From: Mike's Primary Account <mcfletch@caramon.fletchers>
Date: Fri, 20 Apr 2007 13:10:40 -0400
Subject: [PATCH] Initial documentation of presence service overview. Fix weird
 indent in server_plugin module

---
 services/presence/__init__.py      | 36 ++++++++++++++++++++++++++++++
 services/presence/server_plugin.py |  2 +-
 2 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/services/presence/__init__.py b/services/presence/__init__.py
index e69de29b..bd64375a 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 268552c7..3cd078b0 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():