Merge branch 'readonly-p4-donut' into donut

src/com/android/email/MessagingController.java

@@ -247,6 +247,9 @@ public class MessagingController implements Runnable {
 
                         localFolders = localStore.getPersonalNamespaces();
                         
+                        // Signal the remote store that it can now use folder-based callbacks
+                        store.localFolderSetupComplete();
+
                         for (MessagingListener l : mListeners) {
                             l.listFolders(account, localFolders);
                         }

src/com/android/email/mail/Store.java

@@ -193,6 +193,20 @@ public abstract class Store {
 
     public abstract Folder[] getPersonalNamespaces() throws MessagingException;
     
+    /**
+     * This function will be called after the messaging controller has called 
+     * getPersonalNamespaces() and has created a matching set of LocalFolder objects.  This can
+     * be used as a trigger for the store to write back any folder-specific persistent data using
+     * callbacks.
+     * 
+     * This is not abstract because most stores do not require this functionality and do not
+     * need to implement it.
+     */
+    @SuppressWarnings("unused")
+    public void localFolderSetupComplete() throws MessagingException {
+        // Do nothing - return immediately
+    }
+
     public abstract void checkSettings() throws MessagingException;
     
     /**