/* * buflist-command.c - buflist command * * Copyright (C) 2003-2022 Sébastien Helleu * * This file is part of WeeChat, the extensible chat client. * * WeeChat is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 3 of the License, or * (at your option) any later version. * * WeeChat is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with WeeChat. If not, see . */ #include #include "../weechat-plugin.h" #include "buflist.h" #include "buflist-bar-item.h" #include "buflist-command.h" #include "buflist-config.h" /* * Callback for command "/buflist". */ int buflist_command_buflist (const void *pointer, void *data, struct t_gui_buffer *buffer, int argc, char **argv, char **argv_eol) { /* make C compiler happy */ (void) pointer; (void) data; (void) buffer; (void) argv_eol; if (argc == 1) return WEECHAT_RC_OK; if (weechat_strcasecmp (argv[1], "enable") == 0) { weechat_config_option_set (buflist_config_look_enabled, "on", 1); return WEECHAT_RC_OK; } if (weechat_strcasecmp (argv[1], "disable") == 0) { weechat_config_option_set (buflist_config_look_enabled, "off", 1); return WEECHAT_RC_OK; } if (weechat_strcasecmp (argv[1], "toggle") == 0) { weechat_config_option_set (buflist_config_look_enabled, "toggle", 1); return WEECHAT_RC_OK; } if (weechat_strcasecmp (argv[1], "bar") == 0) { buflist_add_bar (); return WEECHAT_RC_OK; } if (weechat_strcasecmp (argv[1], "refresh") == 0) { buflist_bar_item_update (0); return WEECHAT_RC_OK; } WEECHAT_COMMAND_ERROR; } /* * Hooks buflist commands. */ void buflist_command_init () { weechat_hook_command ( "buflist", N_("bar item with list of buffers"), "enable|disable|toggle || bar || refresh", N_(" enable: enable buflist\n" "disable: disable buflist\n" " toggle: toggle buflist\n" " bar: add the \"buflist\" bar\n" "refresh: force the refresh of the bar items (buflist, buflist2 " "and buflist3)\n" "\n" "The lines with buffers are displayed using string evaluation " "(see /help eval for the format), with these options:\n" " - buflist.look.display_conditions: conditions to display a " "buffer in the list\n" " - buflist.format.buffer: format for a buffer which is not " "current buffer\n" " - buflist.format.buffer_current: format for the current buffer\n" "\n" "The following variables can be used in these options:\n" " - bar item data (see hdata \"bar_item\" in API doc for a " "complete list), for example:\n" " - ${bar_item.name}\n" " - window data, where the bar item is displayed (there's no " "window in root bars, see hdata \"window\" in API doc for a " "complete list), for example:\n" " - ${window.number}\n" " - ${window.buffer.full_name}\n" " - buffer data (see hdata \"buffer\" in API doc for a complete " "list), for example:\n" " - ${buffer.number}\n" " - ${buffer.name}\n" " - ${buffer.full_name}\n" " - ${buffer.short_name}\n" " - ${buffer.nicklist_nicks_count}\n" " - irc_server: IRC server data, defined only on an IRC buffer " "(see hdata \"irc_server\" in API doc)\n" " - irc_channel: IRC channel data, defined only on an IRC channel " "buffer (see hdata \"irc_channel\" in API doc)\n" " - extra variables added by buflist for convenience:\n" " - ${format_buffer}: the evaluated value of option " "buflist.format.buffer; this can be used in option " "buflist.format.buffer_current to just change the background color " "for example\n" " - ${current_buffer}: a boolean (\"0\" or \"1\"), \"1\" if " "this is the current buffer; it can be used in a condition: " "${if:${current_buffer}?...:...}\n" " - ${merged}: a boolean (\"0\" or \"1\"), \"1\" if the " "buffer is merged with at least another buffer; it can be used " "in a condition: ${if:${merged}?...:...}\n" " - ${format_number}: indented number with separator " "(evaluation of option buflist.format.number)\n" " - ${number}: indented number, for example \" 1\" if there " "are between 10 and 99 buffers; for merged buffers, this variable " "is set with number for the first buffer and spaces for the next " "buffers with same number\n" " - ${number2}: indented number, for example \" 1\" if there " "are between 10 and 99 buffers\n" " - ${number_displayed}: \"1\" if the number is displayed, " "otherwise \"0\"\n" " - ${indent}: indentation for name (channel and private " "buffers are indented) (evaluation of " "option buflist.format.indent)\n" " - ${format_nick_prefix}: colored nick prefix for a channel " "(evaluation of option buflist.format.nick_prefix)\n" " - ${color_nick_prefix}: color of nick prefix for a channel " "(set only if the option buflist.look.nick_prefix is enabled)\n" " - ${nick_prefix}: nick prefix for a channel " "(set only if the option buflist.look.nick_prefix is enabled)\n" " - ${format_name}: formatted name (evaluation of option " "buflist.format.name)\n" " - ${name}: the short name (if set), with a fallback on the " "name\n" " - ${color_hotlist}: the color depending on the highest " "hotlist level for the buffer (evaluation of option " "buflist.format.hotlist_xxx where xxx is the level)\n" " - ${format_hotlist}: the formatted hotlist (evaluation " "of option buflist.format.hotlist)\n" " - ${hotlist}: the raw hotlist\n" " - ${hotlist_priority}: \"none\", \"low\", \"message\", " "\"private\" or \"highlight\"\n" " - ${format_lag}: the lag for an IRC server buffer, empty if " "there's no lag (evaluation of option buflist.format.lag)\n" " - ${format_tls_version}: indicator of TLS version for a server " "buffer, empty for channels (evaluation of option " "buflist.format.tls_version)"), "enable|disable|toggle || bar || refresh", &buflist_command_buflist, NULL, NULL); }