# HG changeset patch # User Goffi # Date 1727359921 -7200 # Node ID 073bb1d1a7f89f16b1f0191a5c8c2d78ae05cd11 # Parent d27228b3c7047d3608ba87bfb4ed935f6bb76787 doc (cli/message): add documentation for new addressing commands: rel 450 diff -r d27228b3c704 -r 073bb1d1a7f8 doc/libervia-cli/message.rst --- 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