Commit f1bfec33 authored by mathieui's avatar mathieui

Rename "roster" to "contact list"

parent 5a6ba4dd
...@@ -99,7 +99,7 @@ ca_cert_path = ...@@ -99,7 +99,7 @@ ca_cert_path =
#connection_timeout_delay = 30 #connection_timeout_delay = 30
# Send the initial presence # Send the initial presence
# true, unless you want to be invisible from your roster # true, unless you want to be invisible from your contact list
# warning: this disables any presence sending other than chatrooms or directed # warning: this disables any presence sending other than chatrooms or directed
# presences via /presence # presences via /presence
#send_initial_presence = true #send_initial_presence = true
...@@ -306,8 +306,8 @@ use_bookmarks_method = ...@@ -306,8 +306,8 @@ use_bookmarks_method =
# the @) when displaying the chatroom tab name. # the @) when displaying the chatroom tab name.
#show_muc_jid = true #show_muc_jid = true
# If this option is set to false, the roster will not show the contact JIDs # If this option is set to false, the contact list will not show the contact
# when that is possible. # JIDs when that is possible.
# e.g. instead of: toto (toto@example.org) (2) # e.g. instead of: toto (toto@example.org) (2)
# poezio will only show: toto (2) # poezio will only show: toto (2)
#show_roster_jids = true #show_roster_jids = true
...@@ -315,19 +315,19 @@ use_bookmarks_method = ...@@ -315,19 +315,19 @@ use_bookmarks_method =
# Show JIDs in conversation tabs # Show JIDs in conversation tabs
#show_jid_in_conversations = true #show_jid_in_conversations = true
# show s2s errors in the roster # show s2s errors in the contact list
#show_s2s_errors = true #show_s2s_errors = true
# If set to true, the roster will display the offline contacts too # If set to true, the contact list will display offline contacts too
#roster_show_offline = false #roster_show_offline = false
# How to sort the contacts inside the roster groups. # How to sort the contacts inside the contact list groups.
# They are used sequentially, (from left to right) # They are used sequentially, (from left to right)
# Available sorting methods are: # Available sorting methods are:
# - reverse: reverse the sorting # - reverse: reverse the sorting
# - jid: sort by JID (alphabetical order) # - jid: sort by JID (alphabetical order)
# - show: sort by show (available/away/xa/…) # - show: sort by show (available/away/xa/…)
# - name: sort by roster name (if no name, then the bare jid is used) # - name: sort by name (if no name, then the bare jid is used)
# - sname: case-sensitive name sorting (uppercase first) # - sname: case-sensitive name sorting (uppercase first)
# - resource: sort by resource number # - resource: sort by resource number
# - online: sort by online presence (online or not) # - online: sort by online presence (online or not)
...@@ -336,7 +336,7 @@ use_bookmarks_method = ...@@ -336,7 +336,7 @@ use_bookmarks_method =
# sorting is most likely inefficient. # sorting is most likely inefficient.
#roster_sort = jid:show #roster_sort = jid:show
# How to sort the roster groups. # How to sort the contact list groups.
# The principles are the same as roster_sort. # The principles are the same as roster_sort.
# Available methods are: # Available methods are:
# - reverse: reverse the sorting # - reverse: reverse the sorting
...@@ -434,8 +434,8 @@ use_bookmarks_method = ...@@ -434,8 +434,8 @@ use_bookmarks_method =
# defaults to $XDG_CACHE_HOME/poezio/images. # defaults to $XDG_CACHE_HOME/poezio/images.
#tmp_image_dir = #tmp_image_dir =
# Receive the tune notifications or not (in order to display informations # Receive the tune notifications or not (in order to display information
# in the roster). # in the contact list).
# If this is set to false, then the display_tune_notifications # If this is set to false, then the display_tune_notifications
# option will be ignored. # option will be ignored.
#enable_user_tune = true #enable_user_tune = true
...@@ -443,8 +443,8 @@ use_bookmarks_method = ...@@ -443,8 +443,8 @@ use_bookmarks_method =
# Display user gaming notifications as information messages or not # Display user gaming notifications as information messages or not
#display_gaming_notifications = false #display_gaming_notifications = false
# Receive the gaming notifications or not (in order to display informations # Receive the gaming notifications or not (in order to display information
# in the roster). # in the contact list).
# If this is set to false, then the display_gaming_notifications # If this is set to false, then the display_gaming_notifications
# option will be ignored. # option will be ignored.
#enable_user_gaming = true #enable_user_gaming = true
...@@ -452,8 +452,8 @@ use_bookmarks_method = ...@@ -452,8 +452,8 @@ use_bookmarks_method =
# Display user mood notifications as information messages or not # Display user mood notifications as information messages or not
#display_mood_notifications = false #display_mood_notifications = false
# Receive the mood notifications or not (in order to display informations # Receive the mood notifications or not (in order to display information
# in the roster). # in the contact list).
# If this is set to false, then the display_mood_notifications # If this is set to false, then the display_mood_notifications
# option will be ignored. # option will be ignored.
#enable_user_mood = true #enable_user_mood = true
...@@ -461,8 +461,8 @@ use_bookmarks_method = ...@@ -461,8 +461,8 @@ use_bookmarks_method =
# Display user activity notifications as information messages or not # Display user activity notifications as information messages or not
#display_activity_notifications = false #display_activity_notifications = false
# Receive the activity notifications or not (in order to display informations # Receive the activity notifications or not (in order to display information
# in the roster). # in the contact list).
# If this is set to false, then the display_activity_notifications # If this is set to false, then the display_activity_notifications
# option will be ignored. # option will be ignored.
#enable_user_activity = true #enable_user_activity = true
......
...@@ -199,8 +199,8 @@ These commands work in *any* tab. ...@@ -199,8 +199,8 @@ These commands work in *any* tab.
/message /message
**Usage:** ``/message <jid> [optional message]`` **Usage:** ``/message <jid> [optional message]``
Open a conversation with the specified JID (event if it is not in our roster), Open a conversation with the specified JID (event if it is not in our
and send a message to him/her, if specified. contact list), and send a message to them, if specified.
/version /version
**Usage:** ``/version <jid>`` **Usage:** ``/version <jid>``
...@@ -273,8 +273,8 @@ These commands work in *any* tab. ...@@ -273,8 +273,8 @@ These commands work in *any* tab.
/close /close
Close the tab. Close the tab.
.. note:: The /close command will work everywhere, except in the Roster tab, .. note:: The /close command will work everywhere, except in the
which can’t be closed. Contact list tab, which can’t be closed.
.. _chattab-commands: .. _chattab-commands:
...@@ -467,8 +467,8 @@ Normal Conversation tab commands ...@@ -467,8 +467,8 @@ Normal Conversation tab commands
.. _rostertab-commands: .. _rostertab-commands:
Roster tab commands Contact list tab commands
~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~
.. glossary:: .. glossary::
:sorted: :sorted:
...@@ -476,25 +476,25 @@ Roster tab commands ...@@ -476,25 +476,25 @@ Roster tab commands
**Usage:** ``/accept [jid]`` **Usage:** ``/accept [jid]``
Authorize the provided JID (or the selected contact in the Authorize the provided JID (or the selected contact in the
roster) to see your presence. contact list) to see your presence.
/deny /deny
**Usage:** ``/deny [jid]`` **Usage:** ``/deny [jid]``
Prevent the provided JID (or the selected contact in the Prevent the provided JID (or the selected contact in the
roster) from seeing your presence. contact list) from seeing your presence.
/add /add
**Usage:** ``/add <jid>`` **Usage:** ``/add <jid>``
Add the specified JID to your roster and authorize him to see Add the specified JID to your contact list and authorize them to see
your presence. If he accepts you, the subscription will be mutual (and if he your presence. If they accepts you, the subscription will be mutual
doesn’t, you can still /remove him). (and if they don’t, you can still /remove them).
/name /name
**Usage:** ``/name <jid> <name>`` **Usage:** ``/name <jid> <name>``
Set the given JID’s name in your roster. Set the given JID’s name in your contact list.
/password /password
**Usage:** ``/password <password>`` **Usage:** ``/password <password>``
...@@ -506,7 +506,7 @@ Roster tab commands ...@@ -506,7 +506,7 @@ Roster tab commands
Add the given JID to the given group (if the group Add the given JID to the given group (if the group
does not exist, it will be created). If no jid is provided, does not exist, it will be created). If no jid is provided,
the currently selected item on the roster (resource or JID) the currently selected item on the contact list (resource or JID)
will be used. will be used.
/groupmove /groupmove
...@@ -525,9 +525,9 @@ Roster tab commands ...@@ -525,9 +525,9 @@ Roster tab commands
/remove /remove
**Usage:** ``/remove [jid]`` **Usage:** ``/remove [jid]``
Remove the specified JID from your roster. This will Remove the specified JID from your contact list. This will
unsubscribe you from its presence, cancel its subscription to yours, and unsubscribe you from its presence, cancel its subscription to yours, and
remove the item from your roster. remove the item from your contact list.
/reconnect /reconnect
......
...@@ -491,9 +491,9 @@ or the way messages are displayed. ...@@ -491,9 +491,9 @@ or the way messages are displayed.
**Default value:** ``true`` **Default value:** ``true``
The tabs have a name, and a nick, which is, for a contact, its name in The tabs have a name, and a nick, which is, for a contact, its name in
the roster, or for a private conversation, the nickname in the chatroom. the contact list, or for a private conversation, the nickname in the
Set this to ``true`` if you want to have them shown instead of the jid chatroom. Set this to ``true`` if you want to have them shown instead
of the contact. of the jid of the contact.
theme theme
...@@ -661,8 +661,8 @@ or the way messages are displayed. ...@@ -661,8 +661,8 @@ or the way messages are displayed.
**Default value:** ``name`` **Default value:** ``name``
How to sort the roster groups. The principles are the same as :term:`roster_sort` How to sort the contact list groups. The principles are the same
(see below). as :term:`roster_sort` (see below).
Available methods are: Available methods are:
* ``reverse``: reverse the current sorting * ``reverse``: reverse the current sorting
...@@ -682,7 +682,7 @@ or the way messages are displayed. ...@@ -682,7 +682,7 @@ or the way messages are displayed.
**Default value:** ``jid:show`` **Default value:** ``jid:show``
How you want the contacts to be sorted inside the roster groups. The given How you want the contacts to be sorted inside the contact list groups. The given
methods are used sequentially (from left to right), so the last one is the methods are used sequentially (from left to right), so the last one is the
one on the far right. one on the far right.
...@@ -691,7 +691,7 @@ or the way messages are displayed. ...@@ -691,7 +691,7 @@ or the way messages are displayed.
* ``reverse``: reverse the current sorting * ``reverse``: reverse the current sorting
* ``jid``: sort by JID (alphabetical order) * ``jid``: sort by JID (alphabetical order)
* ``show``: sort by show (available/away/xa/…) * ``show``: sort by show (available/away/xa/…)
* ``name``: sort by roster name (if no name, then the bare jid is used) * ``name``: sort by given name (if no name, then the bare jid is used)
* ``resource``: sort by resource number * ``resource``: sort by resource number
* ``online``: sort by online presence (online or not) * ``online``: sort by online presence (online or not)
...@@ -719,9 +719,9 @@ or the way messages are displayed. ...@@ -719,9 +719,9 @@ or the way messages are displayed.
**Default value:** ``true`` **Default value:** ``true``
Set this to ``false`` if you want to hide the JIDs in the roster (and keep only Set this to ``false`` if you want to hide the JIDs in the contact list
the contact names). If there is no contact name, the JID will still be (and keep only the contact names). If there is no contact name, the
displayed. JID will still be displayed.
show_jid_in_conversations show_jid_in_conversations
...@@ -734,13 +734,13 @@ or the way messages are displayed. ...@@ -734,13 +734,13 @@ or the way messages are displayed.
**Default value:** ``true`` **Default value:** ``true``
Show s2s errors in the roster or not. Show s2s errors in the contact list or not.
show_roster_subscriptions show_roster_subscriptions
**Defalt value:** ``[empty]`` **Defalt value:** ``[empty]``
Select the level of display of subscriptions with a char the roster Select the level of display of subscriptions with a char in the contact list.
- ``all`` to display all subscriptions - ``all`` to display all subscriptions
- ``incomplete`` to display *from*, *to* and *none* - ``incomplete`` to display *from*, *to* and *none*
......
...@@ -34,7 +34,7 @@ highlight > message > non-empty input). ...@@ -34,7 +34,7 @@ highlight > message > non-empty input).
**Alt-z**: Go to the previously selected tab. **Alt-z**: Go to the previously selected tab.
**Alt-r**: Go to the roster tab. **Alt-r**: Go to the contact list tab.
**F4**: Toggle the left pane. **F4**: Toggle the left pane.
...@@ -165,10 +165,10 @@ These keys work only in the MultiUserChat List tab (obtained with :term:`/list`) ...@@ -165,10 +165,10 @@ These keys work only in the MultiUserChat List tab (obtained with :term:`/list`)
.. _rostertab-keys: .. _rostertab-keys:
Roster tab input keys Contact list tab input keys
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
These keys work only in the Roster tab (the tab number 0). These keys work only in the Contact list tab (the tab number 0).
**/**: Open a prompt for commands. **/**: Open a prompt for commands.
...@@ -292,7 +292,8 @@ Actions list ...@@ -292,7 +292,8 @@ Actions list
**_close_tab**: Closes the current tab. **_close_tab**: Closes the current tab.
This is the same as :term:`/close`. The first tab (the roster) can not be closed. This is the same as :term:`/close`. The first tab (the contact list) can
not be closed.
**_disconnect**: Disconnects poezio from the server. **_disconnect**: Disconnects poezio from the server.
...@@ -324,7 +325,7 @@ Actions list ...@@ -324,7 +325,7 @@ Actions list
Similar to the default Ctrl-n action. Similar to the default Ctrl-n action.
**_show_roster**: Goes to the roster. **_show_roster**: Goes to the contact list
Similar to Alt-r action. Similar to Alt-r action.
......
...@@ -10,7 +10,7 @@ Those extensions are standardized ways to broadcast informations that might be ...@@ -10,7 +10,7 @@ Those extensions are standardized ways to broadcast informations that might be
useful to your contacts (they will receive those informations only if they useful to your contacts (they will receive those informations only if they
have indicated their interest in them). have indicated their interest in them).
The events are also shown in the roster, next to the contact line: The events are also shown in the contact list, next to the contact line:
.. figure:: ../images/pep.png .. figure:: ../images/pep.png
:alt: Personal Events :alt: Personal Events
...@@ -18,7 +18,7 @@ The events are also shown in the roster, next to the contact line: ...@@ -18,7 +18,7 @@ The events are also shown in the roster, next to the contact line:
On the above figure, A stands for Activity, M for Mood, and G for Gaming. On the above figure, A stands for Activity, M for Mood, and G for Gaming.
The details are shown with notifications if configured, and in the detailed The details are shown with notifications if configured, and in the detailed
contact information window, on the bottom left in the roster tab. contact information window, on the bottom left in the contact list tab.
.. figure:: ../images/pep_infos.png .. figure:: ../images/pep_infos.png
:alt: Personal Events details :alt: Personal Events details
......
...@@ -85,7 +85,7 @@ Plugin index ...@@ -85,7 +85,7 @@ Plugin index
Close all Close all
:ref:`Documentation <closeall-plugin>` :ref:`Documentation <closeall-plugin>`
Close all tabs except chatrooms and the roster. Close all tabs except chatrooms and the contact list.
CSI CSI
:ref:`Documentation <csi-plugin>` :ref:`Documentation <csi-plugin>`
......
...@@ -59,7 +59,7 @@ Generalities ...@@ -59,7 +59,7 @@ Generalities
:ref:`Global shortcuts <global-keys>` :ref:`Global shortcuts <global-keys>`
The tab numbered **0** is always the **roster** tab, the other tabs can be of any The tab numbered **0** is always the **Contact list** tab, the other tabs can be of any
type. type.
.. figure:: ./images/tab_bar.png .. figure:: ./images/tab_bar.png
...@@ -89,8 +89,8 @@ You can go from one tab to another in many ways: ...@@ -89,8 +89,8 @@ You can go from one tab to another in many ways:
.. _rostertab: .. _rostertab:
Roster tab Contact list tab
~~~~~~~~~~ ~~~~~~~~~~~~~~~~
:ref:`Specific commands <rostertab-commands>` :ref:`Specific commands <rostertab-commands>`
...@@ -105,7 +105,7 @@ Use the **direction arrows** (↑↓) to browse the list, the ``Space`` key to ...@@ -105,7 +105,7 @@ Use the **direction arrows** (↑↓) to browse the list, the ``Space`` key to
fold or unfold a group or a contact. fold or unfold a group or a contact.
.. figure:: ./images/roster.png .. figure:: ./images/roster.png
:alt: The roster tab :alt: The contact list tab
#. Area where information messages are displayed. #. Area where information messages are displayed.
#. Actual list of contacts. The first level is group, the second is the #. Actual list of contacts. The first level is group, the second is the
...@@ -195,7 +195,8 @@ Conversation tab ...@@ -195,7 +195,8 @@ Conversation tab
:ref:`Chat shortcuts <chattab-keys>` :ref:`Chat shortcuts <chattab-keys>`
A tab opened from the roster or :term:`/message`, to talk in private with one of your contacts. A tab opened by interacting with the contact list or :term:`/message`,
to talk in private with one of your contacts.
.. figure:: ./images/conversation.png .. figure:: ./images/conversation.png
:alt: The conversation tab :alt: The conversation tab
......
""" """
``close_all`` plugin: close all tabs except chatrooms and the roster. ``close_all`` plugin: close all tabs except chatrooms and the contact lis.
Commands Commands
-------- --------
......
...@@ -13,7 +13,7 @@ Command ...@@ -13,7 +13,7 @@ Command
**Usage (in a chatroom tab):** ``/vcard <jid or nick>`` **Usage (in a chatroom tab):** ``/vcard <jid or nick>``
**Usage (in a conversation or roster tab):** ``/vcard [jid]`` **Usage (in a conversation or contact list tab):** ``/vcard [jid]``
Globally, you can do ``/vcard user@server.example`` to get a vcard. Globally, you can do ``/vcard user@server.example`` to get a vcard.
...@@ -22,8 +22,8 @@ Command ...@@ -22,8 +22,8 @@ Command
user@server.example``). user@server.example``).
In a private or a direct conversation, you can do ``/vcard`` to request In a private or a direct conversation, you can do ``/vcard`` to request
vcard from the current interlocutor, and in the roster to do it on the vcard from the current interlocutor, and in the contact list to do it
currently selected contact. on the currently selected contact.
""" """
from poezio.decorators import command_args_parser from poezio.decorators import command_args_parser
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment