diff --git a/src/net/java/sip/communicator/service/protocol/event/CallChangeListener.java b/src/net/java/sip/communicator/service/protocol/event/CallChangeListener.java
index cb5cf2b5c..f7e7325af 100644
--- a/src/net/java/sip/communicator/service/protocol/event/CallChangeListener.java
+++ b/src/net/java/sip/communicator/service/protocol/event/CallChangeListener.java
@@ -9,11 +9,32 @@
import java.util.*;
/**
- * Allows notification for new call participants, theme changes and
- * other call state events.
+ * A call change listener receives events indicating that a call has changed and
+ * a participant has either left or joined.
+ *
* @author Emil Ivov
*/
-public class CallChangeListener
- implements EventListener
+public interface CallChangeListener
+ extends EventListener
{
+ /**
+ * Indicates that a new call participant has joined the source call.
+ * @param evt the CallParticipantEvent containing the source call
+ * and call participant.
+ */
+ public void callParticipantAdded(CallParticipantEvent evt);
+
+ /**
+ * Indicates that a call participant has left the source call.
+ * @param evt the CallParticipantEvent containing the source call
+ * and call participant.
+ */
+ public void callParticipantRemoved(CallParticipantEvent evt);
+
+ /**
+ * Indicates that a change has occurred in the state of the source call.
+ * @param evt the CallChangeEvent instance containing the source
+ * calls and its old and new state.
+ */
+ public void callStateChanged(CallChangeEvent evt);
}
diff --git a/src/net/java/sip/communicator/service/protocol/event/CallParticipantListener.java b/src/net/java/sip/communicator/service/protocol/event/CallParticipantListener.java
index ceb90b108..511f42629 100644
--- a/src/net/java/sip/communicator/service/protocol/event/CallParticipantListener.java
+++ b/src/net/java/sip/communicator/service/protocol/event/CallParticipantListener.java
@@ -10,10 +10,50 @@
/**
+ * Receives events notifying of changes that have occurred within a
+ * CallParticipant. Such changes may pertain to current call
+ * participant state, their display name, address, image and (possibly in the
+ * future) others.
+ *
* @author Emil Ivov
*/
public interface CallParticipantListener
extends EventListener
{
- public void participantChange(CallParticipantChangeEvent evt);
+
+ /**
+ * Indicates that a change has occurred in the status of the source
+ * CallParticipant.
+ *
+ * @param evt The CallParticipantChangeEvent instance containing
+ * the source event as well as its previous and its new status.
+ */
+ public void participantStateChanged(CallParticipantChangeEvent evt);
+
+ /**
+ * Indicates that a change has occurred in the display name of the source
+ * CallParticipant.
+ *
+ * @param evt The CallParticipantChangeEvent instance containing
+ * the source event as well as its previous and its new display names.
+ */
+ public void participantDisplayNameChanged(CallParticipantChangeEvent evt);
+
+ /**
+ * Indicates that a change has occurred in the address of the source
+ * CallParticipant.
+ *
+ * @param evt The CallParticipantChangeEvent instance containing
+ * the source event as well as its previous and its new address.
+ */
+ public void participantAddressChanged(CallParticipantChangeEvent evt);
+
+ /**
+ * Indicates that a change has occurred in the image of the source
+ * CallParticipant.
+ *
+ * @param evt The CallParticipantChangeEvent instance containing
+ * the source event as well as its previous and its new image.
+ */
+ public void participantImageChanged(CallParticipantChangeEvent evt);
}