From 5a6ba4dda826308fd3ba5abd8cc25fba2166a431 Mon Sep 17 00:00:00 2001 From: mathieui Date: Tue, 4 Oct 2016 00:26:54 +0200 Subject: Replace "MUC" by "chatroom" in the documentation And fix some linewrapping, obsolete references to poezio.eu, and obsolete docs. --- data/default_config.cfg | 24 ++++++------- doc/source/commands.rst | 6 ++-- doc/source/configuration.rst | 72 ++++++++++++++++++++----------------- doc/source/keys.rst | 10 +++--- doc/source/misc/troubleshooting.rst | 2 +- doc/source/plugins/index.rst | 12 ++++--- doc/source/usage.rst | 14 ++++---- plugins/close_all.py | 6 ++-- plugins/random_nick.py | 2 +- plugins/server_part.py | 2 +- plugins/tell.py | 3 +- plugins/time_marker.py | 4 +-- plugins/vcard.py | 4 +-- 13 files changed, 85 insertions(+), 76 deletions(-) diff --git a/data/default_config.cfg b/data/default_config.cfg index 62124839..03fc6565 100644 --- a/data/default_config.cfg +++ b/data/default_config.cfg @@ -100,7 +100,7 @@ ca_cert_path = # Send the initial presence # true, unless you want to be invisible from your roster -# warning: this disables any presence sending other than MUCs or directed +# warning: this disables any presence sending other than chatrooms or directed # presences via /presence #send_initial_presence = true @@ -298,12 +298,12 @@ use_bookmarks_method = # shown #show_tab_numbers = true -# Use the contact name, the nick in the MUC instead of the full JID to +# Use the contact name, the nick in the chatroom instead of the full JID to # display the tab if set to true. #use_tab_nicks = true # If set to false, poezio will only display the user part of the JID (before -# the @) when displaying the MUC tab name. +# 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 @@ -351,11 +351,11 @@ use_bookmarks_method = # The terminal can beep on various event. Put the event you want in a list # (separated by spaces). # The events can be -# - highlight (when you are highlighted in a MUC) +# - highlight (when you are highlighted in a chatroom) # - private (when a new private message is received, from your contacts or -# someone from a MUC) -# - message (any message from a MUC) -# - invite (when you receive an invitation for joining a MUC) +# someone from a chatroiom) +# - message (any message from a chatroom) +# - invite (when you receive an invitation for joining a chatroom) #beep_on = highlight private invite # Theme @@ -392,25 +392,25 @@ use_bookmarks_method = # if set to asc, they will be displayed from bottom to top. #vertical_tab_list_sort = desc -# Show the user list at the bottom when in a MUC +# Show the user list at the bottom when in a chatroom # (useful when you want to look at the bottom of the screen only) # possible values: desc, asc #user_list_sort = desc -# If the MUC nicks should receive a fixed color based on their text or not +# If the chatroom nicks should receive a fixed color based on their text or not #deterministic_nick_colors = true # If _nick, nick_, _nick_, nick__ etc. should have the same color as nick #nick_color_aliases = true -# The nick of people who join, part, change their status, etc. in a MUC will -# be displayed using their nick color if true. +# The nick of people who join, part, change their status, etc. in a chatroom +# will be displayed using their nick color if true. #display_user_color_in_join_part = true # Display user tune notifications as information messages or not #display_tune_notifications = false -# Change the tab state when receiving MUC messages. +# Change the tab state when receiving chatroom messages. # useful if you are connected to a high-volume chatroom and do not # want it to appear in your tab bar as active. Highlights are still # shown. diff --git a/doc/source/commands.rst b/doc/source/commands.rst index a73fa9b3..c69d6cbc 100644 --- a/doc/source/commands.rst +++ b/doc/source/commands.rst @@ -344,7 +344,7 @@ MultiUserChat tab commands this nick. You can also use **random** to attribute a random color. - /clear [MUCTab version] + /clear [Chatroom version] **Usage:** ``/clear`` Clear the messages buffer. @@ -354,7 +354,7 @@ MultiUserChat tab commands Ignore a specified nickname. - /invite [MUCTab version] + /invite [Chatroom version] **Usage:** ``/invite [reason]`` Invite *jid* to this room with *reason* (if @@ -395,8 +395,6 @@ MultiUserChat tab commands **Usage:** ``/nick `` Change your nickname in the current room. - **Except for gmail users** because gmail.com sucks and will do weird things - if you change your nickname in a MUC. /recolor **Usage:** ``/recolor [random]`` diff --git a/doc/source/configuration.rst b/doc/source/configuration.rst index 4f11a558..db762daa 100644 --- a/doc/source/configuration.rst +++ b/doc/source/configuration.rst @@ -490,9 +490,10 @@ 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 MUC. Set this to - ``true`` if you want to have them shown instead of the jid of the contact. + 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. theme @@ -534,8 +535,9 @@ or the way messages are displayed. **Default value:** ``desc`` - If set to ``desc``, the MUC users will be displayed from top to bottom in the list, - if set to ``asc``, they will be displayed from bottom to top. + If set to ``desc``, the chatroom users will be displayed from top to + bottom in the list, if set to ``asc``, they will be displayed from + bottom to top. deterministic_nick_colors @@ -637,8 +639,8 @@ or the way messages are displayed. **Default value:** ``true`` - If set to true, the color of the nick will be used in MUCs information - messages, instead of the default color from the theme. + If set to true, the color of the nick will be used in chatroom + information messages, instead of the default color from the theme. enable_vertical_tab_list @@ -708,9 +710,10 @@ or the way messages are displayed. **Default value:** ``true`` - Set this to ``false`` if you want to display only the “user” part of the MUC - jid. E.g. if you have **poezio@muc.poezio.eu**, it will be displayed as - **poezio**. This will be used only if :term:`use_tab_nicks` is set to ``true``. + Set this to ``false`` if you want to display only the “user” part of the + chatroom jid. E.g. if you have **poezio@muc.poez.io**, it will be + displayed as **poezio**. This will be used only if :term:`use_tab_nicks` + is set to ``true``. show_roster_jids @@ -785,9 +788,9 @@ or the way messages are displayed. **Default:** ``[empty]`` - Fix a color for a nick. Whenever such a nick appears in a MUC, it will - be displayed in that color. This color won't be changed by the recolor - command. + Fix a color for a nick. Whenever such a nick appears in a chatroom, it + will be displayed in that color. This color won't be changed by the + recolor command. User Interaction ~~~~~~~~~~~~~~~~ @@ -820,9 +823,10 @@ Options that change the behavior of poezio in a non-visual manner. (separated by spaces). The events can be - - ``highlight`` (when you are highlighted in a MUC) - - ``private`` (when a new private message is received, from your contacts or someone from a MUC) - - ``message`` (any message from a MUC) + - ``highlight`` (when you are highlighted in a chatroom) + - ``private`` (when a new private message is received, from your + contacts or someone from a chatroom) + - ``message`` (any message from a chatroom) separate_history @@ -973,7 +977,7 @@ Other Send initial presence (normal behaviour). If ``false``, you will not send nor receive any presence that is not directed (through :term:`/presence`) or sent by a - MUC. + chatroom. lazy_resize @@ -1055,8 +1059,8 @@ found. **Default value:** ``false`` - Disable the beeps triggered by this conversation. Works in MucTab, - PrivateTab and ConversationTab. + Disable the beeps triggered by this conversation. Works in chatroom + tabs, private messaging tabs, and conversation tabs. display_activity_notifications @@ -1083,8 +1087,8 @@ found. **Default value:** ``false`` - If set to ``true``, the color of the nick will be used in MUCs information - messages, instead of the default color from the theme. + If set to ``true``, the color of the nick will be used in chatroom + information messages, instead of the default color from the theme. display_tune_notifications @@ -1178,8 +1182,8 @@ found. **Default value:** ``true`` - Lets you disable/enable chatstates per-JID. Works in MucTab, PrivateTab - and ConversationTab. + Lets you disable/enable chatstates per-JID. Works in chatroom tabs, + private messaging tabs, and normal conversation tabs. show_useless_separator @@ -1199,24 +1203,26 @@ found. **Default value:** ``true`` - Only for MUC tabs: if true the tab will change its color to notify you when a new message is received. - You will still be notified of highlights. Set to ``false`` if you’re not interested in a room non-highlight notifications. + Only for chatroom tabs: if true the tab will change its color to + notify you when a new message is received. + You will still be notified of highlights. Set to ``false`` if you are + not interested in a room non-highlight notifications. self_ping_delay **Default value:** ``0`` When this option is set to a positive value ``n``, poezio will send - a ping request to its own nick in the MUC every n seconds of + a ping request to its own nick in the chatroom every n seconds of inactivity (whenever no new message or presence is received from the - MUC room for more than n seconds). If the MUC service does not + chatroom for more than n seconds). If the chatroom service does not respond with a successful pong within 60 seconds (that is: on an - error of the type “not-allowed” which means the MUC service doesn’t - consider us to be present in that room, or on a timeout which - probably means that the service is down), poezio will mark that MUC - room as not joined and will try to re-join it. This is useful to - know when a MUC server crashes or becomes unavailable, because there - is no mechanism to be informed of that fact in XMPP. + error of the type “not-allowed” which means the chatroom service + doesn’t consider us to be present in that room, or on a timeout which + probably means that the service is down), poezio will mark that + chatroom as not joined and will try to re-join it. This is useful to + know when a chatroom server crashes or becomes unavailable, because + there is no mechanism to be informed of that fact in XMPP. A value of at least 60 seconds is recommended, to avoid sending too many requests. diff --git a/doc/source/keys.rst b/doc/source/keys.rst index f1d47b91..41b71078 100644 --- a/doc/source/keys.rst +++ b/doc/source/keys.rst @@ -344,10 +344,10 @@ Actions list Similar to Alt-d. -**_server_cycle**: Cycles in the current MUC server. +**_server_cycle**: Cycles in the current chatroom server. - Similar to :term:`/server_cycle` in a MUC. If you are not in a MUC, you will get - an error. + Similar to :term:`/server_cycle` in a chatroom. If you are not in a + chatroom, you will get an error. **_show_bookmarks**: Shows the current bookmarks. @@ -357,7 +357,7 @@ Actions list Similar to Alt-e. -**_show_invitations**: Shows all the pending MUC invitations. +**_show_invitations**: Shows all the pending chatroom invitations. Similar to :term:`/invitations`. @@ -414,7 +414,7 @@ You only have to prefix your command line with ``_exc_``, and without the ``/`` That key binding will only work in the tabs defining the command (here, the -MUC tab), and will show an error message in the others. +chatroom tab), and will show an error message in the others. Examples ~~~~~~~~ diff --git a/doc/source/misc/troubleshooting.rst b/doc/source/misc/troubleshooting.rst index 3c79a62d..6f8f9316 100644 --- a/doc/source/misc/troubleshooting.rst +++ b/doc/source/misc/troubleshooting.rst @@ -34,7 +34,7 @@ Other issues Some things may appear in ``$XDG_DATA_HOME/poezio/logs/errors.log``. (or a user-defined :term:`log_dir`/errors.log) -.. _web client: https://jappix.com/?r=poezio@muc.poezio.eu +.. _web client: https://jappix.com/?r=poezio@muc.poez.io .. _mcabber: http://mcabber.com/ .. _every: https://bugs.mageia.org/show_bug.cgi?id=2156 .. _significant: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=602720 diff --git a/doc/source/plugins/index.rst b/doc/source/plugins/index.rst index 397ffefe..ea9e13de 100644 --- a/doc/source/plugins/index.rst +++ b/doc/source/plugins/index.rst @@ -69,7 +69,7 @@ Plugin index Admin :ref:`Documentation ` - Creates convenient aliases for MUC administration. + Creates convenient aliases for chatroom administration. Alias :ref:`Documentation ` @@ -85,7 +85,7 @@ Plugin index Close all :ref:`Documentation ` - Close all tabs except MUCs and the roster. + Close all tabs except chatrooms and the roster. CSI :ref:`Documentation ` @@ -173,7 +173,8 @@ Plugin index Screen Detach :ref:`Documentation ` - Changes your status to **away** if the screen (or tmux) poezio is in gets detached. + Changes your status to **away** if the screen (or tmux) poezio is in + gets detached. Send Delayed :ref:`Documentation ` @@ -183,7 +184,8 @@ Plugin index Simple notify :ref:`Documentation ` - Sends a notification with a command of your choice on (non-MUC) messages. + Sends a notification with a command of your choice on (non-chatroom) + messages. Spam :ref:`Documentation ` @@ -198,7 +200,7 @@ Plugin index Tell :ref:`Documentation ` - Tells a message to a nick when he connects to a MUC. + Sends a message to a nick when he connects to a chatroom. Uptime :ref:`Documentation ` diff --git a/doc/source/usage.rst b/doc/source/usage.rst index d74db5ed..ebe7f483 100644 --- a/doc/source/usage.rst +++ b/doc/source/usage.rst @@ -114,8 +114,8 @@ fold or unfold a group or a contact. .. _muctab: -MultiUserChat tab -~~~~~~~~~~~~~~~~~ +Chatroom tab +~~~~~~~~~~~~ :ref:`Specific commands ` @@ -123,10 +123,12 @@ MultiUserChat tab :ref:`Chat shortcuts ` +.. note:: A chatroom is also called a MUC (for Multi-User-Chat) in XMPP terms. + This tab contains a multi-user conversation. .. figure:: ./images/muc.png - :alt: The MUC tab + :alt: The chatroom tab #. The conversation window, this is where all the messages and events related to the muc will be displayed. It can be scrolled up and down with @@ -159,7 +161,7 @@ This tab contains a multi-user conversation. The nicks have a random color given by poezio (which can be changed with :term:`/recolor`) -#. Your information in that MUC (the name of the room, your nick, your role +#. Your information in that chatroom (the name of the room, your nick, your role and affiliation). #. The topic of the room. @@ -210,7 +212,7 @@ Dataforms tab :ref:`Specific shortcuts ` This tab lets you view a form received from a remote entity, edit the values and -send everything back. It is mostly used to configure MUCs with the +send everything back. It is mostly used to configure chatrooms with the :term:`/configure` command but can actually be used for almost anything. .. figure:: ./images/data_forms.png @@ -228,7 +230,7 @@ List tab :ref:`Specific shortcuts ` -This tab lists all public rooms on a MUC service (with the :term:`/list` command). +This tab lists all public rooms on a chatroom service (with the :term:`/list` command). It is currently very limited but will be improved in the future. There currently is no way to search a room. diff --git a/plugins/close_all.py b/plugins/close_all.py index 6d31c05f..70dcd21c 100644 --- a/plugins/close_all.py +++ b/plugins/close_all.py @@ -1,5 +1,5 @@ """ -``close_all`` plugin: close all tabs except MUCs and the roster. +``close_all`` plugin: close all tabs except chatrooms and the roster. Commands -------- @@ -9,7 +9,7 @@ Commands /closeall **Usage:** ``/closeall`` - Close all tabs except the roster and MUC tabs. + Close all tabs except the roster and chatroom tabs. """ from poezio.plugin import BasePlugin from poezio import tabs @@ -19,7 +19,7 @@ from poezio.decorators import command_args_parser class Plugin(BasePlugin): def init(self): self.api.add_command('closeall', self.command_closeall, - help='Close all non-muc tabs.') + help='Close all non-chatroom tabs.') @command_args_parser.ignored def command_closeall(self): diff --git a/plugins/random_nick.py b/plugins/random_nick.py index 66d5661f..643c79f0 100644 --- a/plugins/random_nick.py +++ b/plugins/random_nick.py @@ -1,5 +1,5 @@ """ -This plugin makes you have a random nick when joining a MUC. +This plugin makes you have a random nick when joining a chatroom. Usage ----- diff --git a/plugins/server_part.py b/plugins/server_part.py index 878001e7..08aa663b 100644 --- a/plugins/server_part.py +++ b/plugins/server_part.py @@ -11,7 +11,7 @@ Command **Usage:** ``/server_part [ [message]]`` Leave all rooms on ````, if not provided and the current - tab is a MUC tab, it will leave all rooms on the current server. + tab is a chatroom tab, it will leave all rooms on the current server. ``[message]`` can indicate a quit message. diff --git a/plugins/tell.py b/plugins/tell.py index 57837517..02a091df 100644 --- a/plugins/tell.py +++ b/plugins/tell.py @@ -3,7 +3,8 @@ The command added by this plugin sends a message to someone when he next joins. Usage ----- -This plugin defines two new commands for MUC tabs: :term:`/tell` and :term:`/untell`. +This plugin defines two new commands for chatroom tabs: +:term:`/tell`, :term:`/untell`, and :term:`/list_tell`. .. glossary:: :sorted: diff --git a/plugins/time_marker.py b/plugins/time_marker.py index f215d2b3..43ec11e0 100644 --- a/plugins/time_marker.py +++ b/plugins/time_marker.py @@ -3,8 +3,8 @@ Display the time between two messages. Helps you identify the times of a conversation. For example if you disable the timestamps, and remove the join/quit notifications in a -MUC, you can’t really distinguish when a conversation stopped and when a new -one started, because you don’t have a visual separation between the two. +chatroom, you can’t really distinguish when a conversation stopped and when +a new one started, because you don’t have a visual separation between the two. This plugin displays a message in the conversation indicating the time that passed between two messages, if the time is bigger than X minutes diff --git a/plugins/vcard.py b/plugins/vcard.py index 5acc8d3a..46cacda0 100644 --- a/plugins/vcard.py +++ b/plugins/vcard.py @@ -11,13 +11,13 @@ Command **Usage (globally):** ``/vcard `` - **Usage (in a MUC tab):** ``/vcard `` + **Usage (in a chatroom tab):** ``/vcard `` **Usage (in a conversation or roster tab):** ``/vcard [jid]`` Globally, you can do ``/vcard user@server.example`` to get a vcard. - In a MUC, you can either do it on a JID or a nick (``/vcard nick``, + In a chatroom , you can either do it on a JID or a nick (``/vcard nick``, ``/vcard room@muc.server.example/nick`` or ``/vcard user@server.example``). -- cgit v1.2.3