summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authormathieui <mathieui@mathieui.net>2016-10-04 00:40:56 +0200
committermathieui <mathieui@mathieui.net>2016-10-04 00:40:56 +0200
commitf1bfec332f168364ada51254bce950700a1f5731 (patch)
tree422239c7b0874fd2a562a7abe4383b622f7c3120
parent5a6ba4dda826308fd3ba5abd8cc25fba2166a431 (diff)
downloadpoezio-f1bfec332f168364ada51254bce950700a1f5731.tar.gz
poezio-f1bfec332f168364ada51254bce950700a1f5731.tar.bz2
poezio-f1bfec332f168364ada51254bce950700a1f5731.tar.xz
poezio-f1bfec332f168364ada51254bce950700a1f5731.zip
Rename "roster" to "contact list"
-rw-r--r--data/default_config.cfg32
-rw-r--r--doc/source/commands.rst30
-rw-r--r--doc/source/configuration.rst24
-rw-r--r--doc/source/keys.rst13
-rw-r--r--doc/source/misc/personal_events.rst4
-rw-r--r--doc/source/plugins/index.rst2
-rw-r--r--doc/source/usage.rst11
-rw-r--r--plugins/close_all.py2
-rw-r--r--plugins/vcard.py6
9 files changed, 63 insertions, 61 deletions
diff --git a/data/default_config.cfg b/data/default_config.cfg
index 03fc6565..dd98e493 100644
--- a/data/default_config.cfg
+++ b/data/default_config.cfg
@@ -99,7 +99,7 @@ ca_cert_path =
#connection_timeout_delay = 30
# 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
# presences via /presence
#send_initial_presence = true
@@ -306,8 +306,8 @@ use_bookmarks_method =
# the @) when displaying the chatroom tab name.
#show_muc_jid = true
-# If this option is set to false, the roster will not show the contact JIDs
-# when that is possible.
+# If this option is set to false, the contact list will not show the contact
+# JIDs when that is possible.
# e.g. instead of: toto (toto@example.org) (2)
# poezio will only show: toto (2)
#show_roster_jids = true
@@ -315,19 +315,19 @@ use_bookmarks_method =
# Show JIDs in conversation tabs
#show_jid_in_conversations = true
-# show s2s errors in the roster
+# show s2s errors in the contact list
#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
-# 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)
# Available sorting methods are:
# - reverse: reverse the sorting
# - jid: sort by JID (alphabetical order)
# - 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)
# - resource: sort by resource number
# - online: sort by online presence (online or not)
@@ -336,7 +336,7 @@ use_bookmarks_method =
# sorting is most likely inefficient.
#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.
# Available methods are:
# - reverse: reverse the sorting
@@ -434,8 +434,8 @@ use_bookmarks_method =
# defaults to $XDG_CACHE_HOME/poezio/images.
#tmp_image_dir =
-# Receive the tune notifications or not (in order to display informations
-# in the roster).
+# Receive the tune notifications or not (in order to display information
+# in the contact list).
# If this is set to false, then the display_tune_notifications
# option will be ignored.
#enable_user_tune = true
@@ -443,8 +443,8 @@ use_bookmarks_method =
# Display user gaming notifications as information messages or not
#display_gaming_notifications = false
-# Receive the gaming notifications or not (in order to display informations
-# in the roster).
+# Receive the gaming notifications or not (in order to display information
+# in the contact list).
# If this is set to false, then the display_gaming_notifications
# option will be ignored.
#enable_user_gaming = true
@@ -452,8 +452,8 @@ use_bookmarks_method =
# Display user mood notifications as information messages or not
#display_mood_notifications = false
-# Receive the mood notifications or not (in order to display informations
-# in the roster).
+# Receive the mood notifications or not (in order to display information
+# in the contact list).
# If this is set to false, then the display_mood_notifications
# option will be ignored.
#enable_user_mood = true
@@ -461,8 +461,8 @@ use_bookmarks_method =
# Display user activity notifications as information messages or not
#display_activity_notifications = false
-# Receive the activity notifications or not (in order to display informations
-# in the roster).
+# Receive the activity notifications or not (in order to display information
+# in the contact list).
# If this is set to false, then the display_activity_notifications
# option will be ignored.
#enable_user_activity = true
diff --git a/doc/source/commands.rst b/doc/source/commands.rst
index c69d6cbc..8c0e0d5b 100644
--- a/doc/source/commands.rst
+++ b/doc/source/commands.rst
@@ -199,8 +199,8 @@ These commands work in *any* tab.
/message
**Usage:** ``/message <jid> [optional message]``
- Open a conversation with the specified JID (event if it is not in our roster),
- and send a message to him/her, if specified.
+ Open a conversation with the specified JID (event if it is not in our
+ contact list), and send a message to them, if specified.
/version
**Usage:** ``/version <jid>``
@@ -273,8 +273,8 @@ These commands work in *any* tab.
/close
Close the tab.
- .. note:: The /close command will work everywhere, except in the Roster tab,
- which can’t be closed.
+ .. note:: The /close command will work everywhere, except in the
+ Contact list tab, which can’t be closed.
.. _chattab-commands:
@@ -467,8 +467,8 @@ Normal Conversation tab commands
.. _rostertab-commands:
-Roster tab commands
-~~~~~~~~~~~~~~~~~~~
+Contact list tab commands
+~~~~~~~~~~~~~~~~~~~~~~~~~
.. glossary::
:sorted:
@@ -476,25 +476,25 @@ Roster tab commands
**Usage:** ``/accept [jid]``
Authorize the provided JID (or the selected contact in the
- roster) to see your presence.
+ contact list) to see your presence.
/deny
**Usage:** ``/deny [jid]``
Prevent the provided JID (or the selected contact in the
- roster) from seeing your presence.
+ contact list) from seeing your presence.
/add
**Usage:** ``/add <jid>``
- Add the specified JID to your roster and authorize him to see
- your presence. If he accepts you, the subscription will be mutual (and if he
- doesn’t, you can still /remove him).
+ Add the specified JID to your contact list and authorize them to see
+ your presence. If they accepts you, the subscription will be mutual
+ (and if they don’t, you can still /remove them).
/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
**Usage:** ``/password <password>``
@@ -506,7 +506,7 @@ Roster tab commands
Add the given JID to the given group (if the group
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.
/groupmove
@@ -525,9 +525,9 @@ Roster tab commands
/remove
**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
- remove the item from your roster.
+ remove the item from your contact list.
/reconnect
diff --git a/doc/source/configuration.rst b/doc/source/configuration.rst
index db762daa..24d82f71 100644
--- a/doc/source/configuration.rst
+++ b/doc/source/configuration.rst
@@ -491,9 +491,9 @@ or the way messages are displayed.
**Default value:** ``true``
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.
- Set this to ``true`` if you want to have them shown instead of the jid
- of the contact.
+ the contact list, or for a private conversation, the nickname in the
+ chatroom. Set this to ``true`` if you want to have them shown instead
+ of the jid of the contact.
theme
@@ -661,8 +661,8 @@ or the way messages are displayed.
**Default value:** ``name``
- How to sort the roster groups. The principles are the same as :term:`roster_sort`
- (see below).
+ How to sort the contact list groups. The principles are the same
+ as :term:`roster_sort` (see below).
Available methods are:
* ``reverse``: reverse the current sorting
@@ -682,7 +682,7 @@ or the way messages are displayed.
**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
one on the far right.
@@ -691,7 +691,7 @@ or the way messages are displayed.
* ``reverse``: reverse the current sorting
* ``jid``: sort by JID (alphabetical order)
* ``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
* ``online``: sort by online presence (online or not)
@@ -719,9 +719,9 @@ or the way messages are displayed.
**Default value:** ``true``
- Set this to ``false`` if you want to hide the JIDs in the roster (and keep only
- the contact names). If there is no contact name, the JID will still be
- displayed.
+ Set this to ``false`` if you want to hide the JIDs in the contact list
+ (and keep only the contact names). If there is no contact name, the
+ JID will still be displayed.
show_jid_in_conversations
@@ -734,13 +734,13 @@ or the way messages are displayed.
**Default value:** ``true``
- Show s2s errors in the roster or not.
+ Show s2s errors in the contact list or not.
show_roster_subscriptions
**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
- ``incomplete`` to display *from*, *to* and *none*
diff --git a/doc/source/keys.rst b/doc/source/keys.rst
index 41b71078..57b8c22e 100644
--- a/doc/source/keys.rst
+++ b/doc/source/keys.rst
@@ -34,7 +34,7 @@ highlight > message > non-empty input).
**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.
@@ -165,10 +165,10 @@ These keys work only in the MultiUserChat List tab (obtained with :term:`/list`)
.. _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.
@@ -292,7 +292,8 @@ Actions list
**_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.
@@ -324,7 +325,7 @@ Actions list
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.
diff --git a/doc/source/misc/personal_events.rst b/doc/source/misc/personal_events.rst
index 6bb1ee23..16dd8a5e 100644
--- a/doc/source/misc/personal_events.rst
+++ b/doc/source/misc/personal_events.rst
@@ -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
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
:alt: Personal Events
@@ -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.
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
:alt: Personal Events details
diff --git a/doc/source/plugins/index.rst b/doc/source/plugins/index.rst
index ea9e13de..1ea4d952 100644
--- a/doc/source/plugins/index.rst
+++ b/doc/source/plugins/index.rst
@@ -85,7 +85,7 @@ Plugin index
Close all
:ref:`Documentation <closeall-plugin>`
- Close all tabs except chatrooms and the roster.
+ Close all tabs except chatrooms and the contact list.
CSI
:ref:`Documentation <csi-plugin>`
diff --git a/doc/source/usage.rst b/doc/source/usage.rst
index ebe7f483..477de690 100644
--- a/doc/source/usage.rst
+++ b/doc/source/usage.rst
@@ -59,7 +59,7 @@ Generalities
: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.
.. figure:: ./images/tab_bar.png
@@ -89,8 +89,8 @@ You can go from one tab to another in many ways:
.. _rostertab:
-Roster tab
-~~~~~~~~~~
+Contact list tab
+~~~~~~~~~~~~~~~~
:ref:`Specific commands <rostertab-commands>`
@@ -105,7 +105,7 @@ Use the **direction arrows** (↑↓) to browse the list, the ``Space`` key to
fold or unfold a group or a contact.
.. figure:: ./images/roster.png
- :alt: The roster tab
+ :alt: The contact list tab
#. Area where information messages are displayed.
#. Actual list of contacts. The first level is group, the second is the
@@ -195,7 +195,8 @@ Conversation tab
: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
:alt: The conversation tab
diff --git a/plugins/close_all.py b/plugins/close_all.py
index 70dcd21c..66d9f7ec 100644
--- a/plugins/close_all.py
+++ b/plugins/close_all.py
@@ -1,5 +1,5 @@
"""
-``close_all`` plugin: close all tabs except chatrooms and the roster.
+``close_all`` plugin: close all tabs except chatrooms and the contact lis.
Commands
--------
diff --git a/plugins/vcard.py b/plugins/vcard.py
index 46cacda0..759c9929 100644
--- a/plugins/vcard.py
+++ b/plugins/vcard.py
@@ -13,7 +13,7 @@ Command
**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.
@@ -22,8 +22,8 @@ Command
user@server.example``).
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
- currently selected contact.
+ vcard from the current interlocutor, and in the contact list to do it
+ on the currently selected contact.
"""
from poezio.decorators import command_args_parser