X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Forg%2Fvamsas%2Fclient%2FEvents.java;h=babd39cd1962284f0d4a867273aa61b8ca4731af;hb=349c4a3b6842fd54d791e0a92728dba294b30488;hp=fea1b79c20594601f573a69ce8b085dce59fc0a2;hpb=60d3fb8b4c31842b601284e79906e8f8bc63c4f8;p=vamsas.git

diff --git a/src/org/vamsas/client/Events.java b/src/org/vamsas/client/Events.java
index fea1b79..babd39c 100644
--- a/src/org/vamsas/client/Events.java
+++ b/src/org/vamsas/client/Events.java
@@ -44,18 +44,23 @@ public class Events {
    * allow them to store any updates before an offline copy of the session is
    * created. Any client that handles this should call the
    * IClient.getDocument(), update and then IClient.updateDocument in the same
-   * handler thread.
+   * handler thread (the lock on the document is held until the handler exits).
+   * EventName: <Vamsas-session URN>
+   * NewValue: org.vamsas.client.IClient for session.
    */
   public static final String DOCUMENT_FINALIZEAPPDATA = "org.vamsas.client.events.DocumentFinalizeAppData";
 
   /**
-   * Generated by Vorba stub after the penultimate client makes a call to
-   * closeDocument(). Sequence is as follows : 1. All other vamsas clients have
-   * called closeDocument() 2. Final living client monitors closures, and
+   * Generated by Vorba stub for the sole remaining client, after the penultimate 
+   * client makes a call to finalizeClient(). It is only raised if the session has been modifies since the 
+   * last call to storeDocument() by any application.
+   * TODO: LATER: copies of a document should be on a per-user basis for multi-user sessions. 
+   *  Sequence is as follows : 1. All other vamsas clients have
+   * called finalizeClient() 2. Final living client monitors closures, and
    * realises that it is last. 3. Final client generates event to prompt
    * associated application to inquire if the user wishes to save the document
    * for future reference.
-   *  * Any call to closeDocument in a thread other than the registered
+   *  * Any call to finalizeClient in a thread other than the registered
    * EventListener will block until the RequestToClose handler has exited.
    * 
    */