From 0ef50bfd1e282e995d8abd9eccd5fc518004be96 Mon Sep 17 00:00:00 2001 From: Florian Schmaus Date: Mon, 13 Oct 2014 16:49:28 +0200 Subject: [PATCH] Add javadoc for XMPPConnection.send(PlainStreamElement) --- .../java/org/jivesoftware/smack/XMPPConnection.java | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/smack-core/src/main/java/org/jivesoftware/smack/XMPPConnection.java b/smack-core/src/main/java/org/jivesoftware/smack/XMPPConnection.java index 093f36677..4440b064a 100644 --- a/smack-core/src/main/java/org/jivesoftware/smack/XMPPConnection.java +++ b/smack-core/src/main/java/org/jivesoftware/smack/XMPPConnection.java @@ -154,11 +154,17 @@ public interface XMPPConnection { public void sendPacket(Packet packet) throws NotConnectedException; /** - * + * Send a PlainStreamElement. + *

+ * This method is not meant for end-user usage! It allows sending plain stream elements, which should not be + * done by a user manually. Doing so may result in a unstable or unusable connection. Certain Smack APIs use + * this method to send plain stream elements. + *

+ * * @param element * @throws NotConnectedException */ - public void send(PlainStreamElement element) throws NotConnectedException; + public void send(PlainStreamElement element) throws NotConnectedException; /** * Returns the roster for the user.