changeset 4311:073bb1d1a7f8

doc (cli/message): add documentation for new addressing commands: rel 450
author Goffi <goffi@goffi.org>
date Thu, 26 Sep 2024 16:12:01 +0200
parents d27228b3c704
children e39c8e805488
files doc/libervia-cli/message.rst
diffstat 1 files changed, 13 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/doc/libervia-cli/message.rst	Thu Sep 26 16:12:01 2024 +0200
+++ b/doc/libervia-cli/message.rst	Thu Sep 26 16:12:01 2024 +0200
@@ -16,6 +16,17 @@
 You can encrypt your message using ``--encrypt [ALGORITHM]`` argument, this will create an encrypted session and replace existing one if needed.
 You can manage your encrypted session using ``encryption`` command.
 
+It's possible to send a message to several participants at once (besides group chat),
+using addressing commands like ``--to``, ``--cc``, or ``--bcc``. This works in a similar
+way as for emails. If your server supports it (i.e., if it supports `XEP-0033`_), only
+one message will be sent from Libervia, and the server will handle the rest. If it doesn't
+support multicasting, Libervia will handle it itself and send as many messages as
+necessary.
+
+You can also add metadata to the message to indicate who must get the reply (with
+``--reply-to`` and ``reply-room``) or if the message doesn't expect any reply (with
+``--no-reply``).
+
 examples
 --------
 
@@ -27,10 +38,6 @@
 
   $ echo 'pssst, this message is encrypted' | li message send -e omemo louise@example.net
 
-.. note::
-
-  Fingerprints of your destinee must have been accepted before using OMEMO, else message can't be encrypted
-
 Send a ``normal`` message marked as French with a subject::
 
   $ echo 'Bonjour, je vous écris avec « Libervia »' | li message send -l fr -t normal -S 'Ceci est un message de test'
@@ -94,3 +101,5 @@
 Retrieve 2 first messages of 2019 on Libervia official chat room::
 
   $ li message mam -S 2019-01-01 -s libervia@chat.jabberfr.org -m 2
+
+.. _XEP-0033: https://xmpp.org/extensions/xep-0033.html