Mercurial > libervia-backend

comparison doc/libervia-cli/roster.rst @ 3563:267e4987b58b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
author Goffi <goffi@goffi.org>
date Fri, 11 Jun 2021 09:21:41 +0200
parents c80a0f864b5d
children
comparison
equal deleted inserted replaced
3562:9f599ccbea4e 3563:267e4987b58b
105 ===== 105 =====
106 106
107 This command is used to remove from the roster all contacts which have no subscription or 107 This command is used to remove from the roster all contacts which have no subscription or
108 only partial subscription. 108 only partial subscription.
109 109
110 By default, only contacts without subscription at all are removed. With ``--no_from`` you 110 By default, only contacts without subscription at all are removed. With ``--no-from`` you
111 also remove contacts which have no subscription to you (but you have a subscription to 111 also remove contacts which have no subscription to you (but you have a subscription to
112 them), and with ``--no_to`` you also remove contacts that you are not subscribed to (but 112 them), and with ``--no-to`` you also remove contacts that you are not subscribed to (but
113 who are subscribed to you). 113 who are subscribed to you).
114 114
115 example 115 example
116 ------- 116 -------
117 117
118 Remove all contacts from default profile which have no subscription at all or from which 118 Remove all contacts from default profile which have no subscription at all or from which
119 the default profile is not subscribed to:: 119 the default profile is not subscribed to::
120 120
121 $ li roster purge --no_to 121 $ li roster purge --no-to
122 122
123 resync 123 resync
124 ====== 124 ======
125 125
126 SàT uses `roster versioning`_ to optimize the synchronisation of roster with server on 126 Libervia uses `roster versioning`_ to optimize the synchronisation of roster with server on
127 client connection. This means that once the roster has been retrieved, on each following 127 client connection. This means that once the roster has been retrieved, on each following
128 connection, only the difference of contacts (i.e. which new or removed contacts) is 128 connection, only the difference of contacts (i.e. which new or removed contacts) is
129 received. 129 received.
130 130
131 This command does a full resynchronisation of the roster, or in other words it requests 131 This command does a full resynchronisation of the roster, or in other words it requests