Skip to content

Commit 478e5a3

Browse files
authored
Add client consideration for labeled-response (batch vs non-batch)
1 parent fda4587 commit 478e5a3

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

extensions/labeled-response.md

Lines changed: 24 additions & 0 deletions
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 respond with a batched response, or a non-batched response, based on whether the request generates more than one message.
99+
100+
However, it's difficult to know which will be generated for a given request.
101+
102+
It might depend on server configuration, user 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 @label=NrkWWDvD :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 therefore 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)