Skip to content

Commit de2700c

Browse files
committed
Add client consideration for labeled-response (batch vs non-batch)
1 parent fda4587 commit de2700c

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

extensions/labeled-response.md

+24
Original file line numberDiff line numberDiff line change
@@ -91,6 +91,30 @@ When a client sends a private message to its own nick, `echo-message` will resul
9191

9292
Both methods assume that the server will acknowledge all successful messages, or return a labeled error response, but differ in their attitude towards the semantics of sending and receiving.
9393

94+
### Batched vs. non-batched responses
95+
96+
This section is non-normative.
97+
98+
Servers may give a batched or non-batched response, based on whether the reply consists of more than one message.
99+
100+
However, it's difficult to know which will be generated in advance for a given request.
101+
102+
It might depend on server configuration, modes, or in some cases, may change as a result of future extensions.
103+
104+
For example, `MODE MyNick`:
105+
106+
Client: @label=sdGoz6kZKS MODE MyNick
107+
Server: @label=sdGoz6kZKS :irc.example.com 221 MyNick +itwxz
108+
109+
`MODE MyNick` as an oper:
110+
111+
Client: @label=CtmpopxyQ6 :irc.example.com BATCH +B0aLFZRI labeled-response
112+
Server: @batch=B0aLFZRI :irc.example.com 221 MyNick +iostwxz
113+
Server: @batch=B0aLFZRI :irc.example.com 008 MyNick +bcdfkoqsBOS :Server notice mask
114+
Server: :irc.example.com BATCH -B0aLFZRI
115+
116+
Clients may prefer to handle all labeled responses as if they were a BATCH, even in the single message case, for robustness and compatibility.
117+
94118
## Bouncer implementation considerations
95119

96120
This section is non-normative.

0 commit comments

Comments
 (0)