reply
client tag
Copyright © 2016 James Wheare <james@irccloud.com>
Unlimited redistribution and modification of this document is allowed provided that the above copyright notice and this permission notice remains intact.
This specification is a work-in-progress and may have major incompatible changes without warning.
This specification may change at any time and we do not recommend implementing it in a production environment.
This is a work-in-progress specification.
Software implementing this work-in-progress specification MUST NOT use the
unprefixed +reply
tag name. Instead, implementations SHOULD use the
+draft/reply
tag name to be interoperable with other software
implementing a compatible work-in-progress version.
The final version of the specification will use an unprefixed tag name.
This specification defines a client-only message tag to indicate replies to other messages
Clients wishing to use this tag MUST negotiate the message-tags
capability with the server. Additionally, this tag relies on messages being sent with the msgid
tag. Clients SHOULD negotiate the echo-message
capability in order to receive message IDs for their own messages, and therefore understand any replies.
The reply tag is sent by a client with the client-only prefix +
and its value references the server provided ID of another message:
+draft/reply=<msgid>
This section is non-normative
When displaying replies, take care with the chronology of messages. Clients might choose to display a reply message adjacent to its parent, to make a βthreadβ apparent. This might work well when the messages are close together in the message history, but could cause problems if there have been several intervening messages in the mean time. People following the conversation may not see a reply if itβs hoisted too far into the backlog.
In this situation, it might make more sense to leave the reply in place chronologically, but provide a way to jump to the original message instead.
In this example, a PRIVMSG
is sent to a channel with an ID provided by the server. A client sends a reply to this message and the server sends an echo-message back to the client.
S: @msgid=123 :nick!user@host PRIVMSG #channel :Hello!
C: @+draft/reply=123 PRIVMSG #channel :Hello to you!
S: @msgid=456;+draft/reply=123 :nick2!user2@host2 PRIVMSG #channel :Hello to you!
Software supporting +draft/reply: catgirl, IRCCloud, Goguma, BitBot, Limnoria, Moon Moon, Matrix2051