commenting in Mailbox.java

darcs-hash:20080301055808-5007d-5173c14a57e72be1117b33c75723187f546b9539.gz

diff --git a/src/org/ibex/mail/Mailbox.java b/src/org/ibex/mail/Mailbox.java
index 5c72270..23c62cf 100644 (file)
--- a/src/org/ibex/mail/Mailbox.java
+++ b/src/org/ibex/mail/Mailbox.java
@@ -73,7 +73,11 @@ public abstract class Mailbox extends JS.Obj implements Target {
     public static interface Iterator {
         public abstract Message cur();
         public abstract Headers head();
+
+        // FIXME: change all code to actually use this convention!
+        /** JDBC convention: iterator starts "before the first element" */
         public abstract boolean next();
+
         public abstract void    delete();
 
         /** a unique identifier for this message */