diff --git a/doc/design/assistant/xmpp.mdwn b/doc/design/assistant/xmpp.mdwn
index 284e56fa3b..3c88640216 100644
--- a/doc/design/assistant/xmpp.mdwn
+++ b/doc/design/assistant/xmpp.mdwn
@@ -36,18 +36,23 @@ To these messages, it adds its own tag as
 [extended content](http://xmpp.org/rfcs/rfc6121.html#presence-extended).
 The xml namespace is "git-annex" (not an URL because I hate wasting bandwidth).
 
-To indicate it's pushed changes to a git repo with a given UUID,
-a message that should be sent to all buddies and other clients using the account
-(no explicit pairing needed), a client uses a broadcast presence message with:
+To indicate it's pushed changes to a git repo with a given UUID, a message
+that should be sent to all buddies and other clients using the account (no
+explicit pairing needed), it uses a broadcast presence message containing:
 
 	<git-annex xmlns='git-annex' push="uuid[,uuid...]" />
 
 Multiple UUIDs can be listed when multiple clients were pushed. If the
 git repo does not have a git-annex UUID, an empty string is used.
 
-For pairing, a chat message is sent, also using the git-annex tag:
+To query if other git-annex clients are around, a presence message is used,
+containing:
 
-	<git-annex xmlns='git-annex' pairing="PairReq uuid" />
+	<git-annex xmlns='git-annex' query="" />
+
+For pairing, a chat message is sent, containing:
+
+	<git-annex xmlns='git-annex' pairing="PairReq|PairAck|PairDone uuid" />
 
 ### security