Mercurial > libervia-backend
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