added additional methods and documentation

1 files changed, 27 insertions, 7 deletions

diff --git a/src/net/java/sip/communicator/service/contactlist/event/MetaContactListListener.java b/src/net/java/sip/communicator/service/contactlist/event/MetaContactListListener.java
index 62c66c3..441c8a1 100644
--- a/src/net/java/sip/communicator/service/contactlist/event/MetaContactListListener.java
+++ b/src/net/java/sip/communicator/service/contactlist/event/MetaContactListListener.java
@@ -9,37 +9,57 @@ package net.java.sip.communicator.service.contactlist.event;
 import java.util.EventListener;
 
 /**
+ * A MetaContactListListener can be registered with a MetaContactListService
+ * so that it will receive any changes that have occurred in the contact list
+ * layout.
  *
  * @author Yana Stamcheva
+ * @author Emil Ivov
  */
 public interface MetaContactListListener
     extends EventListener
 {
-    
+
     /**
-     * Indicates that a MetaContact has been successfully added 
+     * Indicates that a MetaContact has been successfully added
      * to the MetaContact list.
      * @param evt the MetaContactListEvent containing the corresponding contact
      */
     public void metaContactAdded(MetaContactEvent evt);
-    
+
+    /**
+     * Indicates that a MetaContact has been modified.
+     * @param evt the MetaContactListEvent containing the corresponding contact
+     */
+    public void metaContactModified(MetaContactEvent evt);
+
+
     /**
      * Indicates that a MetaContact has been removed from the MetaContact list.
      * @param evt the MetaContactListEvent containing the corresponding contact
      */
     public void metaContactRemoved(MetaContactEvent evt);
-    
+
     /**
-     * Indicates that a MetaContactGroup has been successfully added 
+     * Indicates that a MetaContactGroup has been successfully added
      * to the MetaContact list.
      * @param evt the MetaContactListEvent containing the corresponding contact
      */
     public void metaContactGroupAdded(MetaContactGroupEvent evt);
-    
+
+    /**
+     * Indicates that a MetaContactGroup has been modified (e.g. a proto contact
+     * group was removed).
+     *
+     * @param evt the MetaContactListEvent containing the corresponding contact
+     */
+    public void metaContactGroupModified(MetaContactGroupEvent evt);
+
+
     /**
      * Indicates that a MetaContactGroup has been removed from the MetaContact list.
      * @param evt the MetaContactListEvent containing the corresponding contact
      */
     public void metaContactGroupRemoved(MetaContactGroupEvent evt);
-    
+
 }