summaryrefslogtreecommitdiff
path: root/doc/source/configuration.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/source/configuration.rst')
-rw-r--r--doc/source/configuration.rst66
1 files changed, 62 insertions, 4 deletions
diff --git a/doc/source/configuration.rst b/doc/source/configuration.rst
index d0ff5bbe..8d39a7de 100644
--- a/doc/source/configuration.rst
+++ b/doc/source/configuration.rst
@@ -156,6 +156,22 @@ Options related to account configuration, nickname…
your alternative nickname will be "john\_".
+ keyfile
+
+ **Default value:** ``[empty]``
+
+ Path to a PEM private key file to use for certificate authentication
+ through SASL External. If set, :term:`certfile` **MUST** be set as well
+ in order to login.
+
+ certfile
+
+ **Default value:** ``[empty]``
+
+ Path to a PEM certificate file to use for certificate authentication
+ through SASL External. If set, :term:`keyfile` **MUST** be set as well
+ in order to login.
+
resource
**Default value:** ``[empty]``
@@ -220,10 +236,10 @@ well, but you will at least want to know when you get disconnected.
auto_reconnect
- **Default value:** ``false``
+ **Default value:** ``true``
- Auto-reconnects you when you get disconnected. Should not be necessary, so
- the default is false.
+ Auto-reconnects you when you get disconnected from the
+ server. Poezio will try to reconnect forever, until it succeeds.
connection_check_interval
@@ -316,6 +332,14 @@ to understand what is :ref:`carbons <carbons-details>` or
If this is set to ``false``, you will no longer be subscribed to tune events,
and the :term:`display_tune_notifications` option will be ignored.
+ go_to_previous_tab_on_alt_number
+
+ **Default value:** ``false``
+
+ If this is set to ``true``, when Alt+x is pressed, where x is a
+ number, if you are already on the tab number x, you will jump to the
+ previously selected tab. Otherwise you’ll stay on the same tab.
+
group_corrections
**Default value:** ``true``
@@ -324,6 +348,14 @@ to understand what is :ref:`carbons <carbons-details>` or
sender intended it as such. See :ref:`Message Correction <correct-feature>` for
more information.
+
+ force_remote_bookmarks
+
+ **Default value:** ``false``
+
+ Try to retrieve your remote bookmarks, even when your server doesn’t advertise
+ support.
+
use_bookmark_method
**Default value:** ``[empty]``
@@ -495,6 +527,24 @@ or the way messages are displayed.
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.
+ deterministic_nick_colors
+
+ **Default value:** ``true``
+
+ Use a deterministic algorithm to choose the user colors in chatrooms if
+ set to ``true``. Otherwise the colors will be picked randomly.
+
+ The value of this option affects the behavior of :term:`/recolor`.
+
+ nick_color_aliases
+
+ **Default value:** ``true``
+
+ Automatically search for color of nick aliases. For example, if nick is
+ set to red, _nick, nick\_, _nick_, nick\__ etc. will have the same color.
+ Aliases colors are checked first, so that it is still possible to have
+ different colors for nick\_ and nick.
+
vertical_tab_list_size
**Default value:** ``20``
@@ -714,6 +764,14 @@ or the way messages are displayed.
If the message takes more than one line, the popup will stay visible
two more second per additional lines.
+ muc_colors (section)
+
+ **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.
+
User Interaction
~~~~~~~~~~~~~~~~
@@ -793,7 +851,7 @@ Options related to logging.
**Default value:** ``true``
- Logs all the tracebacks and erors of poezio/sleekxmpp in
+ Logs all the tracebacks and erors of poezio/slixmpp in
:term:`log_dir`/errors.log by default. ``false`` disables this option.
use_log