WeeChat Release Notes

A new message with identifier "_nicklist_diff" has been added in relay (WeeChat protocol). WeeChat may decide to send full nicklist or this nicklist diff at any time (depending on size of message, the smaller is sent).

Clients using nicklist must implement it.

For more info about content of message, see document WeeChat Relay Protocol.

The nick prefix/suffix (for example: "<" and ">") are now dynamic and used on display (not stored any more in the line).

Options moved from irc plugin (irc.conf) to core (weechat.conf):

Types and default values for these four options remain unchanged.

Two new options to customize the truncature char (by default "+"):

When these options are enabled (default), the "+" is displayed after the text, replacing the space that should be displayed there.
When turned off, the "+" will replace last char of text.

Example for a nicks "FlashCode" and "fc" with different values for options weechat.look.prefix_align_max, weechat.look.prefix_align_more_after, weechat.look.nick_prefix and weechat.look.nick_suffix:

After /upgrade, if you set new options to non-empty strings, and if old options were set to non-empty strings too, you will see double prefix/suffix on old messages, this is normal behaviour (lines displayed before /upgrade have prefix/suffix saved in prefix, but new lines don’t have them any more).

New options in logger plugin (logger.conf):

Option irc.network.lag_disconnect has been renamed to irc.network.lag_reconnect and value is now a number of seconds (instead of minutes).

IRC plugin is now using modifiers "irc_command_auth" and "irc_message_auth" to hide passwords.

The option irc.look.hide_nickserv_pwd has been removed, and a new option irc.look.nicks_hide_password has been added (by default passwords are hidden only for "nickserv").

A new rmodifier "message_auth" has been added to hide passwords displayed by command "/msg nickserv identify|register|ghost|release" and the rmodifier "nickserv" has been renamed to "command_auth".

If you never added/changed rmodifiers, you can just reset all rmodifiers:

If you added/changed some rmodifiers, do it manually with these commands:

For consistency with other supported languages, the API constants in Lua have been redefined as constants instead of functions.

Therefore, the use of a constant must be changed: the parentheses must be removed.

The old syntax was:

The new syntax is:

The way to give arguments for guile callbacks has been fixed: now arguments are sent individually (instead of a list with all arguments inside).

Therefore, existing guile scripts must be modified accordingly. Moreover, WeeChat now requires Guile ≥ 2.0 to compile.

Conditions in bars have changed, and now an expression is evaluated.

If you have a value with many conditions in a bar, like: nicklist,active, you must now use an expression like: ${nicklist} && ${active} (see the chapter about bars in the WeeChat User’s guide).

Options moved from core (weechat.conf) to irc plugin (irc.conf):

A new bar item has been added: buffer_modes and irc option irc.look.item_channel_modes has been removed; to display irc channel modes in status bar (after channel name), you have to manually add the new item buffer_modes (this is now used by default in status bar items), default value for status bar items becomes:

New options in command /aspell:

Options renamed in command /aspell:

An horizontal separator has been added between split windows, and two options have been added to toggle separators (both are enabled by default):

New keys were added, use command /key missing to add them or /key listdiff to see differences between your current keys and WeeChat default keys.

Options weechat.look.prefix_align_more and weechat.look.prefix_buffer_align_more have been converted from type boolean to string:

Option weechat.look.paste_max_lines can now be used with value 0 to detect paste with one line (only if terminal "bracketed paste mode" is enabled when option weechat.look.paste_bracketed is on); so now the value -1 is used to disable paste detection: if your value was 0, you should set it to -1

Rmodifier "nickserv" has a new default regex which includes option "release" for command "/msg nickserv".

If you never added/changed rmodifiers, you can just reset all rmodifiers:

If you added/changed some rmodifiers, do it manually with these commands:

Option scroll_unread has been moved from command /input to /window, therefore default command of key alt+"u" has been updated. To bind key with new default value:

Option weechat.history.max_lines has been renamed to weechat.history.max_buffer_lines_number.

Option weechat.plugin.extension now supports list of extensions, and new default value is ".so,.dll" (with this value, weechat.conf is compatible with Cygwin).

Extended regex is used in filters and irc ignore, so some chars that needed escape in past do not need any more (for example [0-9]\+ becomes [0-9]+), filters and ignore have to be manually fixed.

Option weechat.look.highlight_regex becomes case insensitive by default, to make it case sensitive, use "(?-i)" at beginning of string, for example: "(?-i)FlashCode|flashy".

Option weechat.look.hline_char has been renamed to weechat.look.separator_horizontal.

Bold is not used any more for basic colors (used only if terminal has less than 16 colors), a new option has been added to force bold if needed: weechat.look.color_basic_force_bold.

If you have some colors defined in section "palette" with version 0.3.4, you should remove all colors defined, and add new aliases (it’s not needed any more to add colors before using them).

Colors for nick prefixes (char for op, voice, ..) are defined in a single option irc.color.nick_prefixes, therefore following options will be lost: irc.color.nick_prefix_op, irc.color.nick_prefix_halfop, irc.color.nick_prefix_voice, irc.color.nick_prefix_user.

New keys were added, use command /key missing to add them or /key listdiff to see differences between your current keys and WeeChat default keys.

If you are using /upgrade from a previous release:

Some IRC options have been renamed, before upgrading to this version, note value for old options, and set them again with new name:

If you are using /upgrade from a previous release, then you must reconnect to IRC servers in order to use new command /wallchops.

Option irc.look.show_away_once has been renamed to irc.look.display_pv_away_once.

Option irc.network.lag_min_show is now in milliseconds, you should set new value: your current value multiplied by 1000 (new default value is 500).

If you are using /upgrade from a previous release, then you must execute this command on all IRC servers/channels/private buffers and xfer DCC chats (not needed on WeeChat core buffer or buffers from other plugins/scripts):

IRC commands /ame and /amsg are now aliases, if you are upgrading from version 0.3.0, you must create aliases with following commands:

For users of any previous version, all your charset settings in weechat.rc will be LOST! You should save your weechat.rc to keep your values and set them again with new charset plugin.

For ISO users: history of channels may be without accents (after /upgrade), this is not recoverable, but this is not a bug. All new messages should be OK.

Be careful, now default encode is UTF-8 for all channels (before it was terminal charset). If you still want to send messages as ISO-8859-1, you should set either global encode or server specific encode to ISO-8859-1.

For global encode:

For server encode (on server buffer):

New keys for topic scroll: F9/F10.

Key F10 was used for infobar_clear in previous WeeChat versions, you have to manually rebind this key (except for new WeeChat users):

Which gives something like:

If you upgraded with /upgrade in WeeChat, you should /disconnect and then /reconnect on each server, to display properly channel/user modes.

If you’re using plugins, you should remove some old plugins libraries in WeeChat system library directory (commonly /usr/local/lib/weechat/plugins): remove lib* files (like libperl.*, libpython.*, ..) and keep only new libraries (perl.*, python.*, ..).

Please close all DCC chat buffers before using /upgrade command, otherwise you may experience problems with DCC chats.

Some changes in script API: now timer handlers functions takes exactly 0 (zero) argument (in version 0.1.8, two arguments were mandatory but not used: server and arguments).

After installing 0.1.8 (or with /upgrade), issue both commands (if you didn’t redefine these keys (alt+{home|end}):

Then launch again WeeChat (or issue /upgrade).

It is recommended for users of version 0.1.7 (or any older), to replace values in setup file (~/.weechat/weechat.rc):

The string %h is replaced by WeeChat home (default: ~/.weechat, may be overridden by new command line argument --dir).

Keys alt+{home|end} were used for nicklist scroll, they’re now replaced by alt+{F11|F12}.

Ruby script plugin has been added but is experimental in this release. You’re warned!

Command /away was changed to be RFC 2812 compliant. Now argument is required to set away, and no argument means remove away ("back").

Option irc_default_msg_away has been removed.

Incompatibility with some old scripts: now all handlers have to return a code for completion, and to do some actions about message to ignore (please look at documentation for detail).

On OpenBSD, the new option plugins_extension should be set to .so.0.0 since the plugins names are ending by .so.0.0 and not .so.

With new and full UTF-8 support, the option look_charset_internal should be set to blank for most cases. Forces it only if your locale is not properly detected by WeeChat (you can set UTF-8 or ISO-8859-15 for example, depending on your locale). WeeChat is looking for UTF-8 in your locale name at startup.