From 8101b21c715e12e5643b3279f855caac7d2ff7f1 Mon Sep 17 00:00:00 2001
From: guus <guus@b35dd754-fafc-0310-a699-88a17e54d16e>
Date: Tue, 12 Jan 2010 11:28:01 +0000
Subject: [PATCH] Added a bit of javadoc, explaining when the event is (not)
 fired.

git-svn-id: http://svn.igniterealtime.org/svn/repos/smack/trunk@11519 b35dd754-fafc-0310-a699-88a17e54d16e
---
 source/org/jivesoftware/smack/RosterListener.java | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/source/org/jivesoftware/smack/RosterListener.java b/source/org/jivesoftware/smack/RosterListener.java
index a0dd8597b..8be9ddcba 100644
--- a/source/org/jivesoftware/smack/RosterListener.java
+++ b/source/org/jivesoftware/smack/RosterListener.java
@@ -72,6 +72,10 @@ public interface RosterListener {
      * That will return the presence value for the user with the highest priority and
      * availability.
      *
+     * Note that this listener is triggered for presence (mode) changes only
+     * (e.g presence of types available and unavailable. Subscription-related
+     * presence packets will not cause this method to be called.
+     *
      * @param presence the presence that changed.
      * @see Roster#getPresence(String)
      */