add come comments from Hartmut so they don't get lost

git-svn-id: https://svn.ibp.de/svn/capisuite/trunk/capisuite@427 4ebea2bb-67d4-0310-8558-a5799e421b66

src/capisuite-py/delivery.py

@@ -40,6 +40,8 @@ class UserDelivery:
         """
         pass
 
+    # Hartmut: We should define and document all allowed convertions.
+    # Otherwise this will become hell.
     def sendFile(self,recipient,subject,information,file,format):
         """
         Send the 'file' together with the given 'information' (multi-line

src/capisuite-py/storage.py

@@ -48,6 +48,9 @@ class ItemStorage:
         """
         pass
 
+    # Hartmut: What about returning an open filehandle? This would allow 
+    # passing file-like-objects if some day the coure will be implemented
+    # in Python.
     def getItem(self,queue,id):
         """
         Get entry with name 'id' from the queue 'queue'. Must return a file name
@@ -62,7 +65,8 @@ class ItemStorage:
         """
         pass
 
-    def getNewItemName(self,queue):
+    # Hartmut: Is this really needed? Do we need 'stale' IDs?
+    def getNewItemId(self,queue):
         """
         Return a new uniqe name for an item to be stored in the 'queue'.
         """