summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authormathieui <mathieui@mathieui.net>2016-10-04 00:26:54 +0200
committermathieui <mathieui@mathieui.net>2016-10-04 00:29:19 +0200
commit5a6ba4dda826308fd3ba5abd8cc25fba2166a431 (patch)
tree8ef6c6f010ff1feed1a4fb56e17fe955a7ff9ae7
parentc5e80b968862b4fe54d394ed278466f3eb02dd41 (diff)
downloadpoezio-5a6ba4dda826308fd3ba5abd8cc25fba2166a431.tar.gz
poezio-5a6ba4dda826308fd3ba5abd8cc25fba2166a431.tar.bz2
poezio-5a6ba4dda826308fd3ba5abd8cc25fba2166a431.tar.xz
poezio-5a6ba4dda826308fd3ba5abd8cc25fba2166a431.zip
Replace "MUC" by "chatroom" in the documentation
And fix some linewrapping, obsolete references to poezio.eu, and obsolete docs.
-rw-r--r--data/default_config.cfg24
-rw-r--r--doc/source/commands.rst6
-rw-r--r--doc/source/configuration.rst72
-rw-r--r--doc/source/keys.rst10
-rw-r--r--doc/source/misc/troubleshooting.rst2
-rw-r--r--doc/source/plugins/index.rst12
-rw-r--r--doc/source/usage.rst14
-rw-r--r--plugins/close_all.py6
-rw-r--r--plugins/random_nick.py2
-rw-r--r--plugins/server_part.py2
-rw-r--r--plugins/tell.py3
-rw-r--r--plugins/time_marker.py4
-rw-r--r--plugins/vcard.py4
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 <jid> [reason]``
Invite *jid* to this room with *reason* (if
@@ -395,8 +395,6 @@ MultiUserChat tab commands
**Usage:** ``/nick <nickname>``
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 <admin-plugin>`
- Creates convenient aliases for MUC administration.
+ Creates convenient aliases for chatroom administration.
Alias
:ref:`Documentation <alias-plugin>`
@@ -85,7 +85,7 @@ Plugin index
Close all
:ref:`Documentation <closeall-plugin>`
- Close all tabs except MUCs and the roster.
+ Close all tabs except chatrooms and the roster.
CSI
:ref:`Documentation <csi-plugin>`
@@ -173,7 +173,8 @@ Plugin index
Screen Detach
:ref:`Documentation <screendetach-plugin>`
- 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 <senddelayed-plugin>`
@@ -183,7 +184,8 @@ Plugin index
Simple notify
:ref:`Documentation <simplenotify-plugin>`
- 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 <spam-plugin>`
@@ -198,7 +200,7 @@ Plugin index
Tell
:ref:`Documentation <tell-plugin>`
- 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 <uptime-plugin>`
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 <muctab-commands>`
@@ -123,10 +123,12 @@ MultiUserChat tab
:ref:`Chat shortcuts <chattab-keys>`
+.. 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 <forms-keys>`
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 <muclisttab-keys>`
-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 [<server> [message]]``
Leave all rooms on ``<server>``, 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 <jid>``
- **Usage (in a MUC tab):** ``/vcard <jid or nick>``
+ **Usage (in a chatroom tab):** ``/vcard <jid or nick>``
**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``).