# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1411400464 -7200
# Node ID e37180aa68dbb4b95c2c543ee4278225468deb25
# Parent  7ee650e7ac0ac402a4ade9dda70b5f04d0b95e60
Added docstrings and removed superfluous reply handling code.

diff -r 7ee650e7ac0a -r e37180aa68db imip_agent.py
--- a/imip_agent.py	Mon Sep 22 17:10:51 2014 +0200
+++ b/imip_agent.py	Mon Sep 22 17:41:04 2014 +0200
@@ -113,9 +113,6 @@
         self.sequence = get_value(details, "SEQUENCE")
         self.store = imip_store.FileStore()
 
-    def publish(self):
-        pass
-
     def get_attr_value(self, name, single=True):
         return get_attr_value(self.details, name, single)
 
@@ -123,6 +120,9 @@
         return get_value(self.details, name, single)
 
 class Event(Handler):
+
+    "An event handler."
+
     def add(self):
         pass
 
@@ -135,25 +135,41 @@
     def declinecounter(self):
         pass
 
+    def publish(self):
+        pass
+
     def refresh(self):
         pass
 
     def reply(self):
+
+        "Since this handler does not send requests, it will not handle replies."
+
         pass
 
     def request(self):
         pass
 
 class Freebusy(Handler):
+
+    "A free/busy handler."
+
+    def publish(self):
+        pass
+
     def reply(self):
-        attendees = self.get_value("ATTENDEE", False)
-        organiser = self.get_value("ORGANIZER")
-        if not attendees and not organiser:
-            return
 
-        # Store the reply details for the attendee.
+        "Since this handler does not send requests, it will not handle replies."
+
+        pass
 
     def request(self):
+
+        """
+        Respond to a request by sending a reply containing free/busy information
+        for each indicated attendee.
+        """
+
         attendees = self.get_attr_value("ATTENDEE", False)
         organiser = self.get_attr_value("ORGANIZER")
 
@@ -195,13 +211,22 @@
             out.close()
 
 class Journal(Handler):
+
+    "A journal entry handler."
+
     def add(self):
         pass
 
     def cancel(self):
         pass
 
+    def publish(self):
+        pass
+
 class Todo(Handler):
+
+    "A to-do item handler."
+
     def add(self):
         pass
 
@@ -214,10 +239,16 @@
     def declinecounter(self):
         pass
 
+    def publish(self):
+        pass
+
     def refresh(self):
         pass
 
     def reply(self):
+
+        "Since this handler does not send requests, it will not handle replies."
+
         pass
 
     def request(self):