From 8c9b3d5c626025e4a32ce5db177cac81e321089a Mon Sep 17 00:00:00 2001 From: Florian Schmaus Date: Mon, 19 Jan 2015 16:12:16 +0100 Subject: [PATCH] Improve RosterPacket.ItemType javadoc --- .../org/jivesoftware/smack/packet/RosterPacket.java | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/smack-core/src/main/java/org/jivesoftware/smack/packet/RosterPacket.java b/smack-core/src/main/java/org/jivesoftware/smack/packet/RosterPacket.java index c1408a880..8e36462e3 100644 --- a/smack-core/src/main/java/org/jivesoftware/smack/packet/RosterPacket.java +++ b/smack-core/src/main/java/org/jivesoftware/smack/packet/RosterPacket.java @@ -313,22 +313,27 @@ public class RosterPacket extends IQ { public static enum ItemType { /** - * The user and subscriber have no interest in each other's presence. + * The user does not have a subscription to the contact's presence, and the contact does not + * have a subscription to the user's presence; this is the default value, so if the + * subscription attribute is not included then the state is to be understood as "none". */ none, /** - * The user is interested in receiving presence updates from the subscriber. + * The user has a subscription to the contact's presence, but the contact does not have a + * subscription to the user's presence. */ to, /** - * The subscriber is interested in receiving presence updates from the user. + * The contact has a subscription to the user's presence, but the user does not have a + * subscription to the contact's presence. */ from, /** - * The user and subscriber have a mutual interest in each other's presence. + * The user and the contact have subscriptions to each other's presence (also called a + * "mutual subscription"). */ both,