From 86df178654934ee9f64359e0f9327f423f050260 Mon Sep 17 00:00:00 2001 From: rcollier Date: Mon, 20 Jan 2014 02:52:44 +0000 Subject: [PATCH] SMACK-464 Updated javadoc to make method usage more clear. git-svn-id: http://svn.igniterealtime.org/svn/repos/smack/branches/smack_3_4_0@13869 b35dd754-fafc-0310-a699-88a17e54d16e --- source/org/jivesoftware/smack/Connection.java | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/source/org/jivesoftware/smack/Connection.java b/source/org/jivesoftware/smack/Connection.java index d1d9cd41b..925c26ef0 100644 --- a/source/org/jivesoftware/smack/Connection.java +++ b/source/org/jivesoftware/smack/Connection.java @@ -593,10 +593,14 @@ public abstract class Connection { } /** - * Registers a packet listener with this connection. A packet filter determines + * Registers a packet listener with this connection. A packet listener will be invoked only + * when an incoming packet is received. A packet filter determines * which packets will be delivered to the listener. If the same packet listener * is added again with a different filter, only the new filter will be used. * + *

+ * NOTE: If you want get a similar callback for outgoing packets, see {@link #addPacketInterceptor(PacketInterceptor, PacketFilter)}. + * * @param packetListener the packet listener to notify of new received packets. * @param packetFilter the packet filter to use. */ @@ -681,6 +685,9 @@ public abstract class Connection { * invoked every time a packet is about to be sent by this connection. Interceptors * may modify the packet to be sent. A packet filter determines which packets * will be delivered to the interceptor. + * + *

+ * NOTE: For a similar functionality on incoming packets, see {@link #addPacketListener(PacketListener, PacketFilter)}. * * @param packetInterceptor the packet interceptor to notify of packets about to be sent. * @param packetFilter the packet filter to use.