about summary refs log tree commit diff
diff options
context:
space:
mode:
authorJune McEnroe <june@causal.agency>2020-02-27 04:39:01 -0500
committerJune McEnroe <june@causal.agency>2020-02-27 04:39:01 -0500
commit73b11916edc8caba66c9cc6e8e04279ad4b2e2d2 (patch)
tree99f4a90514a18ad1f3c53cb4f6bb2f4fc21ed98b
parentSet consumer pos with CAP REQ causal.agency/consumer=n (diff)
downloadpounce-73b11916edc8caba66c9cc6e8e04279ad4b2e2d2.tar.gz
pounce-73b11916edc8caba66c9cc6e8e04279ad4b2e2d2.zip
Document the causal.agency/consumer vendor capability
-rw-r--r--pounce.150
1 files changed, 50 insertions, 0 deletions
diff --git a/pounce.1 b/pounce.1
index ad1d71f..7b3e5bf 100644
--- a/pounce.1
+++ b/pounce.1
@@ -568,6 +568,56 @@ daemon implements the following:
 .Re
 .El
 .
+.Ss Extensions
+The
+.Sy causal.agency/consumer
+vendor-specific IRCv3 capability
+enables the
+.Sy causal.agency/pos
+message tag.
+The value of this tag
+is a 64-bit unsigned integer
+indicating the consumer position of the client
+after receiving each message,
+e.g.\&
+.Ql @causal.agency/pos=42069 .
+This capability may be requested
+with the value of the last
+.Sy causal.agency/pos
+tag received by the client,
+e.g.\&
+.Ql CAP REQ causal.agency/consumer=42069 ,
+setting its consumer position.
+By persisting this value across connections,
+a client can ensure no messages are missed,
+even in case of network issues or application crashes.
+.
+.Pp
+.%T IRCv3 Client Capability Negotiation
+specifies that capabilities MAY have values in
+.Ql CAP LS
+or
+.Ql CAP NEW
+responses.
+It does not, however,
+indicate if
+.Ql CAP REQ
+capabilities MUST NOT have values.
+The
+.Nm
+daemon parses
+.Ql CAP REQ
+values in the same way as
+.Ql CAP LS
+values.
+.
+.Pp
+The
+.Sy causal.agency/passive
+vendor-specific IRCv3 capability
+indicates that a client
+should not affect the automatic away status.
+.
 .Sh AUTHORS
 .An June Bug Aq Mt june@causal.agency
 .