comments modified to display fine in javadoc

git-svn-id: http://svn.igniterealtime.org/svn/repos/smack/trunk@2034 b35dd754-fafc-0310-a699-88a17e54d16e
This commit is contained in:
Gaston Dombiak 2003-08-18 20:18:19 +00:00 committed by gdombiak
parent 69f8d71a65
commit e516bf8730
2 changed files with 36 additions and 28 deletions

View File

@ -58,11 +58,13 @@ package org.jivesoftware.smackx;
* Message event requests are received when the received message includes an extension * Message event requests are received when the received message includes an extension
* like this: * like this:
* *
* <x xmlns='jabber:x:event'> * <pre>
* <offline/> * &lt;x xmlns='jabber:x:event'&gt;
* <delivered/> * &lt;offline/&gt;
* <composing/> * &lt;delivered/&gt;
* </x> * &lt;composing/&gt;
* &lt;/x&gt;
* </pre>
* *
* In this example you can see that the sender of the message requests to be notified * In this example you can see that the sender of the message requests to be notified
* when the user couldn't receive the message because he/she is offline, the message * when the user couldn't receive the message because he/she is offline, the message

View File

@ -58,30 +58,32 @@ import org.jivesoftware.smack.packet.PacketExtension;
/** /**
* Represents message events relating to the delivery, display, composition and cancellation of * Represents message events relating to the delivery, display, composition and cancellation of
* messages. * messages.<p>
* *
* There are four message events currently defined in this namespace: * There are four message events currently defined in this namespace:
* 1.Offline * <ol>
* <li>Offline<br>
* Indicates that the message has been stored offline by the intended recipient's server. This * Indicates that the message has been stored offline by the intended recipient's server. This
* event is triggered only if the intended recipient's server supports offline storage, has that * event is triggered only if the intended recipient's server supports offline storage, has that
* support enabled, and the recipient is offline when the server receives the message for delivery. * support enabled, and the recipient is offline when the server receives the message for delivery.</li>
* *
* 2.Delivered * <li>Delivered<br>
* Indicates that the message has been delivered to the recipient. This signifies that the message * Indicates that the message has been delivered to the recipient. This signifies that the message
* has reached the recipient's XMPP client, but does not necessarily mean that the message has * has reached the recipient's XMPP client, but does not necessarily mean that the message has
* been displayed. This event is to be raised by the XMPP client. * been displayed. This event is to be raised by the XMPP client.</li>
* *
* 3.Displayed * <li>Displayed<br>
* Once the message has been received by the recipient's XMPP client, it may be displayed to the * Once the message has been received by the recipient's XMPP client, it may be displayed to the
* user. This event indicates that the message has been displayed, and is to be raised by the * user. This event indicates that the message has been displayed, and is to be raised by the
* XMPP client. Even if a message is displayed multiple times, this event should be raised only * XMPP client. Even if a message is displayed multiple times, this event should be raised only
* once. * once.</li>
* *
* 4.Composing * <li>Composing<br>
* In threaded chat conversations, this indicates that the recipient is composing a reply to a * In threaded chat conversations, this indicates that the recipient is composing a reply to a
* message. The event is to be raised by the recipient's XMPP client. A XMPP client is allowed * message. The event is to be raised by the recipient's XMPP client. A XMPP client is allowed
* to raise this event multiple times in response to the same request, providing the original * to raise this event multiple times in response to the same request, providing the original
* event is cancelled first. * event is cancelled first.</li>
* </ol>
* *
* @author Gaston Dombiak * @author Gaston Dombiak
*/ */
@ -305,27 +307,31 @@ public class MessageEvent implements PacketExtension {
* Returns the XML representation of a Message Event according the specification. * Returns the XML representation of a Message Event according the specification.
* *
* Usually the XML representation will be inside of a Message XML representation like * Usually the XML representation will be inside of a Message XML representation like
* in the following examples: * in the following examples:<p>
* *
* Request to be notified when displayed: * Request to be notified when displayed:
* <message * <pre>
* &lt;message
* to='romeo@montague.net/orchard' * to='romeo@montague.net/orchard'
* from='juliet@capulet.com/balcony' * from='juliet@capulet.com/balcony'
* id='message22'> * id='message22'&gt;
* <x xmlns='jabber:x:event'> * &lt;x xmlns='jabber:x:event'&gt;
* <displayed/> * &lt;displayed/&gt;
* </x> * &lt;/x&gt;
* </message> * &lt;/message&gt;
* </pre>
* *
* Notification of displayed: * Notification of displayed:
* <message * <pre>
* &lt;message
* from='romeo@montague.net/orchard' * from='romeo@montague.net/orchard'
* to='juliet@capulet.com/balcony'> * to='juliet@capulet.com/balcony'&gt;
* <x xmlns='jabber:x:event'> * &lt;x xmlns='jabber:x:event'&gt;
* <displayed/> * &lt;displayed/&gt;
* <id>message22</id> * &lt;id&gt;message22&lt;/id&gt;
* </x> * &lt;/x&gt;
* </message> * &lt;/message&gt;
* </pre>
* *
*/ */
public String toXML() { public String toXML() {