doc (cli/message): add documentation for new addressing commands:

rel 450
This commit is contained in:
Goffi 2024-09-26 16:12:01 +02:00
commit c1ed8306ae

View file

@ -16,6 +16,17 @@ Send a message to a contact or a chat room.
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 @@ Send a message encrypted with OMEMO::
$ 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 messages from last 5 hours on Libervia official chat room::
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