Comment most options by default in the config file

It’s a bit late for that, but we have to do this in order to ensure new
setting values will be used after an update if the user didn’t willingly
change them.
This commit is contained in:
mathieui 2016-06-05 13:59:39 +02:00
parent acf22faecf
commit 2225d13ad1

View file

@ -1,6 +1,9 @@
# This is the default config for the XMPP client Poezio.
# Comments should be on their own line and NOT at the end
# of a meaningful line.
# Most options are commented in order to not override the
# default value which may have been changed since the time
# the file was copied on setup.
[Poezio]
@ -54,7 +57,7 @@ resource =
# The server used for anonymous connection.
# Make sure the server you're using accepts anonymous authentication
server = anon.jeproteste.info
#server = anon.jeproteste.info
# TLS Certificate fingerprint
# Do not touch this if you dont know what you are doing
@ -64,20 +67,20 @@ certificate =
# this list prioritizes forward secrecy and forbids anything
# weaker than 128 bits.
# You should probably leave it as it is
ciphers = HIGH+kEDH:HIGH+kEECDH:HIGH:!PSK:!SRP:!3DES:!aNULL
#ciphers = HIGH+kEDH:HIGH+kEECDH:HIGH:!PSK:!SRP:!3DES:!aNULL
# Skip the TLS certificate fingerprint verification
# Should be false in most cases, as you want to check that the server keeps
# the same certificate.
ignore_certificate = false
#ignore_certificate = false
# Force TLS on by default
force_encryption = true
#force_encryption = true
# The interval to send a whitespace keepalive to the server
# 300 should be fine, except for specific services, in that case, change the
# value to the services default.
whitespace_interval = 300
#whitespace_interval = 300
# Path to the certificate authenticating the Authority
# A server may have several certificates, but if it uses a CA, it will often
@ -87,41 +90,41 @@ whitespace_interval = 300
ca_cert_path =
# Auto-reconnects you when you get disconnected from the server
auto_reconnect = true
#auto_reconnect = true
# The time between the ping sent to the server to check if the connection is alive
connection_check_interval = 60
#connection_check_interval = 60
# The timeout value of those pings
connection_timeout_delay = 10
#connection_timeout_delay = 10
# 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
# presences via /presence
send_initial_presence = true
#send_initial_presence = true
# The status (show) poezio will send when connecting.
# can be: xa,dnd,away,available,chat.
# An empty or invalid value will mean available.
status =
#status =
# The status message you will have upon connection
status_message =
# Save the last used status in this file (in the status and status_message
# options)
save_status = true
#save_status = true
# A custom host that will be used instead of the DNS records for the server
# (anonymous or the jids) defined above.
# You should not need this in a "normal" use case.
custom_host =
#custom_host =
# A custom port to use instead of the 5222.
# This option can be combined with custom_host.
# You should not need this in a "normal" use case.
custom_port =
#custom_port =
# the method that poezio will use to store your bookmarks online
# possible values are: privatexml, pep
@ -130,44 +133,44 @@ use_bookmarks_method =
# use this option to force the use of local bookmarks
# possible values are: anything/false
use_remote_bookmarks = true
#use_remote_bookmarks = true
# Force the retrieval of the remote bookmarks even when the server
# doesn't advertise support for your method
force_remote_bookmarks = false
#force_remote_bookmarks = false
# Whether you want all bookmarks, even those without
# autojoin, to be open on startup
open_all_bookmarks = false
#open_all_bookmarks = false
# What will be put after the name, when using autocompletion at the
# beginning of the input. A space will always be added after that
after_completion = ,
#after_completion = ,
# Whether or not to add a space after a completion in the middle of the
# input (not at the start of it)
add_space_after_completion = true
#add_space_after_completion = true
# The maximum length of the nickname that will be displayed in the
# conversation window.
max_nick_length = 25
#max_nick_length = 25
# Show the timestamp of each messages, or not
show_timestamps = true
#show_timestamps = true
# Allow a message to "correct" another message in the display if
# the sender wants it.
group_corrections = true
#group_corrections = true
# Words that you want to complete on recent words completion,
# separated by a colon (:).
# e.g. words = "anticonstitutionnellement:I protest:I like bananas:"
words =
#words =
# XHTML-IM is an XMPP extension letting users send messages
# containing XHTML and CSS formating. We can use this to make
# colored text for example.
enable_xhtml_im = true
#enable_xhtml_im = true
# Set a number for this setting.
# The join OR status-change notices will be
@ -183,9 +186,9 @@ enable_xhtml_im = true
# - status changes won't be displayed unless
# the user talked in the last 2 minutes
hide_exit_join = -1
#hide_exit_join = -1
hide_status_change = 120
#hide_status_change = 120
# Some informational messages (error, a contact getting connected, etc)
@ -194,30 +197,30 @@ hide_status_change = 120
# A list of message types that should make the information buffer grow
# Possible values; error, roster, warning, info, help
information_buffer_popup_on = error roster warning help info
#information_buffer_popup_on = error roster warning help info
# The time the message will be visible. If the message takes more than
# one line, the popup will stay visible two second per additional lines
popup_time = 4
#popup_time = 4
# Whether to hide the list of user in the MultiUserChat tabs or not. Useful
# for example if you want to copy/paste the content of the buffer, or if you
# want to gain space
hide_user_list = false
#hide_user_list = false
# A list of words (or sentences) separated by colons (":"). All the
# informational messages (described above) containing at least one of those
# values will not be shown.
filter_info_messages =
#filter_info_messages =
# Set to 'true' if you want to automatically rejoin the
# rooms when you're kicked or banned
autorejoin = false
#autorejoin = false
# Set to the number of seconds before reconnecting when you are kicked
# or banned. No value, 0, or a negative value means you will be reconnected
# instantly. Only effective if autorejoin is set to true.
autorejoin_delay = 5
#autorejoin_delay = 5
# If you want poezio to join
# the room with an alternative nickname when
@ -229,34 +232,34 @@ autorejoin_delay = 5
# For example, if you set "_", and wanted to use
# the nickname "john", your alternative nickname
# will be "john_"
alternative_nickname =
#alternative_nickname =
# set to 'true' if you want to save logs of all the messages
# in files.
use_log = false
#use_log = false
# The number of lines to preload in a chat buffer when it opens
# (the lines are preloaded from the log files)
# 0 or a negative value disable that option
load_log = 10
#load_log = 10
# If log_dir is not set, logs will be saved in $XDG_DATA_HOME/poezio/logs,
# i.e. in ~/.local/share/poezio/logs/. So, you should specify the directory
# you want to use instead. This directory will be created if it doesn't exist
log_dir =
#log_dir =
# Log the errors poezio encounters in log_dir/errors.log
# A false value disables this option.
log_errors = true
#log_errors = true
# If plugins_dir is not set, plugins will be loaded from the plugins/ dir in the
# poezio directory, then $XDG_DATA_HOME/poezio/plugins.
# You can specify another directory to use. It will be created if it doesn't exist
plugins_dir =
#plugins_dir =
# If plugins_conf_dir is not set, plugin configs will be loaded from
# $XDG_CONFIG_HOME/poezio/plugins. You can specify another directory here.
plugins_conf_dir =
#plugins_conf_dir =
# the full path to the photo (avatar) you want to use
# it should be less than 16Ko
@ -267,7 +270,7 @@ plugins_conf_dir =
# If you want to show all the tabs in the Tab bar, even those
# with no activity, set to true. Else, set to false
show_inactive_tabs = true
#show_inactive_tabs = true
# If you want to highlight tabs where the contact is typing
# possible values:
@ -277,41 +280,41 @@ show_inactive_tabs = true
# - muc: chatrooms
# - true: all chat tabs
# - false or anything else: no highlighting
show_composing_tabs = direct
#show_composing_tabs = direct
# Ignore private messages received in chatrooms
ignore_private = false
#ignore_private = false
# If you want to show the tab names in the bottom tab bar, set this to true
show_tab_names = false
#show_tab_names = false
# If you want to disable the numbers in the bottom tab bar, set this to false
# If show_tab_names and show_tab_numbers are both false, the numbers will be
# If show_tab_names and show_tab_numbers are both false, the numbers will be
# shown
show_tab_numbers = true
#show_tab_numbers = true
# Use the contact name, the nick in the MUC instead of the full JID to
# display the tab if set to true.
use_tab_nicks = 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.
show_muc_jid = true
#show_muc_jid = true
# If this option is set to false, the roster 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
#show_roster_jids = true
# Show JIDs in conversation tabs
show_jid_in_conversations = true
#show_jid_in_conversations = true
# show s2s errors in the roster
show_s2s_errors = true
#show_s2s_errors = true
# If set to true, the roster will display the offline contacts too
roster_show_offline = false
#roster_show_offline = false
# How to sort the contacts inside the roster groups.
# They are used sequentially, (from left to right)
@ -326,7 +329,7 @@ roster_show_offline = false
# You can arrange them however you like, and you have to separate them with
# colons (":"). Keep in mind that if there are more than 3 or 4 your
# sorting is most likely inefficient.
roster_sort = jid:show
#roster_sort = jid:show
# How to sort the roster groups.
# The principles are the same as roster_sort.
@ -338,7 +341,7 @@ roster_sort = jid:show
# - connected: sort by number of connected contacts
# - size: sort by group size
# - none: put the "none" group (if any) at the end of the list
roster_group_sort = name
#roster_group_sort = name
# The terminal can beep on various event. Put the event you want in a list
# (separated by spaces).
@ -348,7 +351,7 @@ roster_group_sort = name
# someone from a MUC)
# - message (any message from a MUC)
# - invite (when you receive an invitation for joining a MUC)
beep_on = highlight private invite
#beep_on = highlight private invite
# Theme
@ -356,112 +359,112 @@ beep_on = highlight private invite
# i.e. in ~/.local/share/poezio/themes/. So you should specify the directory you
# want to use instead. This directory will be created at startup if it doesn't
# exist
themes_dir =
#themes_dir =
# The name of the theme file that will be used. The file should be located
# in the theme_dir directory.
# If the file is not found (or no filename is specified) the default
# theme will be used instead
theme = default
#theme = default
# Whether to create gaps when moving or closing a tab
# (a gap means that the number of your tabs does not depend of the previous tabs
# but only of the creation order)
create_gaps = false
#create_gaps = false
# If Alt-x is pressed and you are already on the tab numbered "x",
# you will go on the previous tab if that option is true
go_to_previous_tab_on_alt_number = false
#go_to_previous_tab_on_alt_number = false
# If true, a vertical list of tabs, with their name, is displayed on the left of
# the screen.
enable_vertical_tab_list = false
#enable_vertical_tab_list = false
# Horizontal size of the vertical tab list
vertical_tab_list_size = 20
#vertical_tab_list_size = 20
# If set to desc, the tabs will be displayed from top to bottom in the list,
# if set to asc, they will be displayed from bottom to top.
vertical_tab_list_sort = desc
#vertical_tab_list_sort = desc
# Show the user list at the bottom when in a MUC
# (useful when you want to look at the bottom of the screen only)
# possible values: desc, asc
user_list_sort = desc
#user_list_sort = desc
# If the MUC nicks should receive a fixed color based on their text or not
deterministic_nick_colors = true
#deterministic_nick_colors = true
# If _nick, nick_, _nick_, nick__ etc. should have the same color as nick
nick_color_aliases = true
#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.
display_user_color_in_join_part = true
#display_user_color_in_join_part = true
# Display user tune notifications as information messages or not
display_tune_notifications = false
#display_tune_notifications = false
# Change the tab state when receiving MUC 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.
notify_messages = true
#notify_messages = true
# Enable Message Carbons (XEP-0280) to deliver message copies from and to
# other resources with carbons enabled.
enable_carbons = true
#enable_carbons = true
# Acknowledge message delivery receipts (XEP-0184)
ack_message_receipts = true
#ack_message_receipts = true
# Ask for message delivery receipts (XEP-0184)
request_message_receipts = true
#request_message_receipts = true
# Extract base64 images received in XHTML-IM messages
# if true.
extract_inline_images = true
#extract_inline_images = true
# The directory where the images will be saved; if unset,
# defaults to $XDG_CACHE_HOME/poezio/images.
tmp_image_dir =
#tmp_image_dir =
# Receive the tune notifications or not (in order to display informations
# in the roster).
# If this is set to false, then the display_tune_notifications
# option will be ignored.
enable_user_tune = true
#enable_user_tune = true
# 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
# in the roster).
# If this is set to false, then the display_gaming_notifications
# option will be ignored.
enable_user_gaming = true
#enable_user_gaming = true
# 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
# in the roster).
# If this is set to false, then the display_mood_notifications
# option will be ignored.
enable_user_mood = true
#enable_user_mood = true
# 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
# in the roster).
# If this is set to false, then the display_activity_notifications
# option will be ignored.
enable_user_activity = true
#enable_user_activity = true
# If set to true, use the nickname broadcasted by the user if none has been
# set manually.
enable_user_nick = true
#enable_user_nick = true
# if true, chat states will be sent to the people you are talking to.
# Chat states are, for example, messages informing that you are composing
@ -469,62 +472,62 @@ enable_user_nick = true
# Set to false if you don't want people to know these information
# Note that you wont receive the chat states of your contacts
# if you don't send yours.
send_chat_states = true
#send_chat_states = true
# if true, information about the software (name and version)
# will be sent if requested by anyone
# Set to false if you don't want people to know these information
send_poezio_info = true
#send_poezio_info = true
# if true, information about the Operation System you're using
# will be sent when requested by anyone
# Set to false if you don't want people to know these information
# Note that this information will not be sent if send_poezio_info is False
send_os_info = true
#send_os_info = true
# if true, your current time will be sent if asked
# Set to false if you don't want people to know that information
send_time = true
#send_time = true
# If true, the history of the similar inputs won't be shared between
# different tabs (as in weechat).
separate_history = false
#separate_history = false
# The language you specify using.
# This *may* be used by an automated entity to send you tailored replies
# If you don't understand, leave en.
lang = en
#lang = en
# Configure the number of maximum lines and messages (for each tab) that
# can be kept in memory. If poezio consumes too much memory, lower these
# values
max_messages_in_memory = 2048
max_lines_in_memory = 2048
#max_messages_in_memory = 2048
#max_lines_in_memory = 2048
# Show the separator at the bottom of the text buffer, even if no one
# spoke
show_useless_separator = true
#show_useless_separator = true
# Set this to true if you want the commands to be executed remotely
# (with ssh & the daemon), see the documentation of the /link plugin
# for details
exec_remote = false
#exec_remote = false
# Path of the FIFO in which the remote commands will be sent.
# The "poezio.fifo" file will be created in this directory
# Used with exec_remote set to true, see the documentation of /link for details
# Defaults to ./
remote_fifo_path = ./
#remote_fifo_path = ./
# Defines if all tabs are resized at the same time (if set to false)
# or if they are really resized only when needed (if set to true).
# “true” should be the most comfortable value
lazy_resize = true
#lazy_resize = true
[bindings]
# Bindings are keyboard shortcut aliases. You can use them
# to define your own keys and bind them with some functions
# The syntaxe is
# The syntax is
# key = bind
# where ^x means Control + x
# and M-x means Alt + x