From 1a4c1eedeb9dacac8396e82dcd8ce6071e019efd Mon Sep 17 00:00:00 2001
From: gernot <gernot@4ebea2bb-67d4-0310-8558-a5799e421b66>
Date: Wed, 26 Jan 2005 21:02:59 +0000
Subject: [PATCH] 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 | 2 ++
 src/capisuite-py/storage.py  | 6 +++++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/capisuite-py/delivery.py b/src/capisuite-py/delivery.py
index 67bc014..1bc10ce 100644
--- a/src/capisuite-py/delivery.py
+++ b/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
diff --git a/src/capisuite-py/storage.py b/src/capisuite-py/storage.py
index d36321f..1dd9fc2 100644
--- a/src/capisuite-py/storage.py
+++ b/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'.
         """