# HG changeset patch
# User Goffi <goffi@goffi.org>
# Date 1657462509 -7200
# Node ID e183f1fbfa8d83bcd27df3ab98302c1da8d30e14
# Parent  f599e0e364448508b0da8bea111005cce67a14e3
doc (cli/pubsub): add doc for ``reference`` subcommand:

rel 369

diff -r f599e0e36444 -r e183f1fbfa8d doc/libervia-cli/pubsub.rst
--- a/doc/libervia-cli/pubsub.rst	Sun Jul 10 16:15:09 2022 +0200
+++ b/doc/libervia-cli/pubsub.rst	Sun Jul 10 16:15:09 2022 +0200
@@ -195,7 +195,7 @@
   $ li pubsub subscriptions --public -s pierre@example.net
 
 affiliations
-=============
+============
 
 Retrieve affiliations for all nodes at a service.
 
@@ -212,6 +212,20 @@
 
   $ li pubsub affiliations -s pubsub@example.net -n notes
 
+reference
+=========
+
+Send a reference (e.g. a mention) of a pubsub item to an entity.
+
+example
+-------
+
+Pierre send a reference to Louise to indicate that she has been mentioned in his blog post
+with ID ``from-paris-to-noumea-abcd``::
+
+  $ li pubsub reference -s pierre@example.net -n urn:xmpp:microblog:0 -i from-paris-to-noumea-abcd louise@example.org
+
+
 search
 ======