comparison doc/libervia-cli/message.rst @ 3488:c80a0f864b5d

doc: updated doc following global renaming
author Goffi <goffi@goffi.org>
date Sun, 21 Mar 2021 18:23:58 +0100
parents doc/jp/message.rst@ddff0ade14d6
children 4705f80b6e23
comparison
equal deleted inserted replaced
3487:75427f0a5445 3488:c80a0f864b5d
1 .. highlight:: sh
2
3 ================================
4 message: chat message management
5 ================================
6
7 Message commands let you send chat messages or manage your server message archives.
8
9 .. _libervia-cli_message_send:
10
11 send
12 ====
13
14 Send a message to a contact or a chat room.
15 ``stdin`` is used as message source.
16 You can encrypt your message using ``--encrypt [ALGORITHM]`` argument, this will create an encrypted session and replace existing one if needed.
17 You can manage your encrypted session using ``encryption`` command.
18
19 examples
20 --------
21
22 Send a message to a contact::
23
24 $ echo 'Salut à Toi!' | li message send louise@example.net
25
26 Send a message encrypted with OMEMO::
27
28 $ echo 'pssst, this message is encrypted' | li message send -e omemo louise@example.net
29
30 .. note::
31
32 Fingerprints of your destinee must have been accepted before using OMEMO, else message can't be encrypted
33
34 Send a ``normal`` message marked as French with a subject::
35
36 $ echo 'Bonjour, je vous écris avec « Salut à Toi »' | li message send -l fr -t normal -S 'Ceci est un message de test'
37
38 mam
39 ===
40
41 Query archives using MAM.
42 This command allows you to check message archive kept on the server (i.e. not the local copy).
43 You usually want to specify a starting point, and a number of message to retrieve. If too many messages
44 are available, you'll have to use RSM commands to navigate through the results.
45
46 examples
47 --------
48
49 Retrieve messages from last 2 days::
50
51 $ li message mam -S "2 days ago"
52
53 Retrieve messages from last 5 hours on SàT official chat room::
54
55 $ li message mam -S "5 hours ago" -s sat@chat.jabberfr.org
56
57 Retrieve 2 first messages of 2019 on SàT official chat room::
58
59 $ li message mam -S 2019-01-01 -s sat@chat.jabberfr.org -m 2