2011-01-01 16:51:21 +00:00
|
|
|
/* $OpenBSD$ */
|
|
|
|
|
|
|
|
/*
|
2016-01-19 15:59:12 +00:00
|
|
|
* Copyright (c) 2011 Nicholas Marriott <nicholas.marriott@gmail.com>
|
2011-01-01 16:51:21 +00:00
|
|
|
*
|
|
|
|
* Permission to use, copy, modify, and distribute this software for any
|
|
|
|
* purpose with or without fee is hereby granted, provided that the above
|
|
|
|
* copyright notice and this permission notice appear in all copies.
|
|
|
|
*
|
|
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
|
|
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
|
|
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
|
|
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
|
|
* WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
|
|
|
|
* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
|
|
|
|
* OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <sys/types.h>
|
|
|
|
|
|
|
|
#include <string.h>
|
|
|
|
#include <paths.h>
|
|
|
|
|
|
|
|
#include "tmux.h"
|
|
|
|
|
|
|
|
/*
|
|
|
|
* This file has a tables with all the server, session and window
|
|
|
|
* options. These tables are the master copy of the options with their real
|
|
|
|
* (user-visible) types, range limits and default values. At start these are
|
|
|
|
* copied into the runtime global options trees (which only has number and
|
2014-04-17 11:38:35 +00:00
|
|
|
* string types). These tables are then used to look up the real type when the
|
|
|
|
* user sets an option or its value needs to be shown.
|
2011-01-01 16:51:21 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
/* Choice option type lists. */
|
2016-10-03 22:52:11 +00:00
|
|
|
static const char *options_table_mode_keys_list[] = {
|
2011-01-01 16:51:21 +00:00
|
|
|
"emacs", "vi", NULL
|
|
|
|
};
|
2016-10-03 22:52:11 +00:00
|
|
|
static const char *options_table_clock_mode_style_list[] = {
|
2011-01-01 16:51:21 +00:00
|
|
|
"12", "24", NULL
|
|
|
|
};
|
2019-03-18 20:53:33 +00:00
|
|
|
static const char *options_table_status_list[] = {
|
|
|
|
"off", "on", "2", "3", "4", "5", NULL
|
|
|
|
};
|
2016-10-03 22:52:11 +00:00
|
|
|
static const char *options_table_status_keys_list[] = {
|
2011-01-01 16:51:21 +00:00
|
|
|
"emacs", "vi", NULL
|
|
|
|
};
|
2016-10-03 22:52:11 +00:00
|
|
|
static const char *options_table_status_justify_list[] = {
|
2011-01-01 16:51:21 +00:00
|
|
|
"left", "centre", "right", NULL
|
|
|
|
};
|
2016-10-03 22:52:11 +00:00
|
|
|
static const char *options_table_status_position_list[] = {
|
2012-01-29 09:37:02 +00:00
|
|
|
"top", "bottom", NULL
|
|
|
|
};
|
2016-10-03 22:52:11 +00:00
|
|
|
static const char *options_table_bell_action_list[] = {
|
2015-05-12 15:27:46 +00:00
|
|
|
"none", "any", "current", "other", NULL
|
2011-01-01 16:51:21 +00:00
|
|
|
};
|
2017-07-26 16:14:08 +00:00
|
|
|
static const char *options_table_visual_bell_list[] = {
|
|
|
|
"off", "on", "both", NULL
|
|
|
|
};
|
2016-10-03 22:52:11 +00:00
|
|
|
static const char *options_table_pane_status_list[] = {
|
2016-04-29 15:00:48 +00:00
|
|
|
"off", "top", "bottom", NULL
|
|
|
|
};
|
2017-06-03 17:43:01 +00:00
|
|
|
static const char *options_table_set_clipboard_list[] = {
|
|
|
|
"off", "external", "on", NULL
|
|
|
|
};
|
Support for windows larger than visible on the attached client. This has
been a limitation for a long time.
There are two new options, window-size and default-size, and a new
command, resize-window. The force-width and force-height options and the
session_width and session_height formats have been removed.
The new window-size option tells tmux how to work out the size of
windows: largest means it picks the size of the largest session,
smallest the smallest session (similar to the old behaviour) and manual
means that it does not automatically resize windows. The default is
currently largest but this may change. aggressive-resize modifies the
choice of session for largest and smallest as it did before.
If a window is in a session attached to a client that is too small, only
part of the window is shown. tmux attempts to keep the cursor visible,
so the part of the window displayed is changed as the cursor moves (with
a small delay, to try and avoid excess redrawing when applications
redraw status lines or similar that are not currently visible). The
offset of the visible portion of the window is shown in status-right.
Drawing windows which are larger than the client is not as efficient as
those which fit, particularly when the cursor moves, so it is
recommended to avoid using this on slow machines or networks (set
window-size to smallest or manual).
The resize-window command can be used to resize a window manually. If it
is used, the window-size option is automatically set to manual for the
window (undo this with "setw -u window-size"). resize-window works in a
similar way to resize-pane (-U -D -L -R -x -y flags) but also has -a and
-A flags. -a sets the window to the size of the smallest client (what it
would be if window-size was smallest) and -A the largest.
For the same behaviour as force-width or force-height, use resize-window
-x or -y, and "setw -u window-size" to revert to automatic sizing..
If the global window-size option is set to manual, the default-size
option is used for new windows. If -x or -y is used with new-session,
that sets the default-size option for the new session.
The maximum size of a window is 10000x10000. But expect applications to
complain and much higher memory use if making a window excessively
big. The minimum size is the size required for the current layout
including borders.
The refresh-client command can be used to pan around a window, -U -D -L
-R moves up, down, left or right and -c returns to automatic cursor
tracking. The position is reset when the current window is changed.
2018-10-18 08:38:01 +00:00
|
|
|
static const char *options_table_window_size_list[] = {
|
|
|
|
"largest", "smallest", "manual", NULL
|
|
|
|
};
|
2011-01-01 16:51:21 +00:00
|
|
|
|
2019-03-18 20:53:33 +00:00
|
|
|
/* Status line format. */
|
|
|
|
#define OPTIONS_TABLE_STATUS_FORMAT1 \
|
|
|
|
"#[align=left range=left #{status-left-style}]" \
|
|
|
|
"#{T;=/#{status-left-length}:status-left}#[norange default]" \
|
|
|
|
"#[list=on align=#{status-justify}]" \
|
|
|
|
"#[list=left-marker]<#[list=right-marker]>#[list=on]" \
|
|
|
|
"#{W:" \
|
2019-03-19 21:09:51 +00:00
|
|
|
"#[range=window|#{window_index} " \
|
|
|
|
"#{window-status-style}" \
|
|
|
|
"#{?#{&&:#{window_last_flag}," \
|
|
|
|
"#{!=:#{window-status-last-style},default}}, " \
|
|
|
|
"#{window-status-last-style}," \
|
|
|
|
"}" \
|
|
|
|
"#{?#{&&:#{window_bell_flag}," \
|
|
|
|
"#{!=:#{window-status-bell-style},default}}, " \
|
|
|
|
"#{window-status-bell-style}," \
|
2019-04-02 18:41:24 +00:00
|
|
|
"#{?#{&&:#{||:#{window_activity_flag}," \
|
|
|
|
"#{window_silence_flag}}," \
|
2019-03-19 21:09:51 +00:00
|
|
|
"#{!=:" \
|
|
|
|
"#{window-status-activity-style}," \
|
|
|
|
"default}}, " \
|
|
|
|
"#{window-status-activity-style}," \
|
2019-03-18 20:53:33 +00:00
|
|
|
"}" \
|
2019-03-19 21:09:51 +00:00
|
|
|
"}" \
|
2019-03-18 20:53:33 +00:00
|
|
|
"]" \
|
|
|
|
"#{T:window-status-format}" \
|
|
|
|
"#[norange default]" \
|
|
|
|
"#{?window_end_flag,,#{window-status-separator}}" \
|
|
|
|
"," \
|
2019-03-19 21:09:51 +00:00
|
|
|
"#[range=window|#{window_index} list=focus " \
|
2019-04-07 20:18:20 +00:00
|
|
|
"#{?#{!=:#{window-status-current-style},default}," \
|
|
|
|
"#{window-status-current-style}," \
|
|
|
|
"#{window-status-style}" \
|
|
|
|
"}" \
|
2019-03-19 21:09:51 +00:00
|
|
|
"#{?#{&&:#{window_last_flag}," \
|
|
|
|
"#{!=:#{window-status-last-style},default}}, " \
|
|
|
|
"#{window-status-last-style}," \
|
|
|
|
"}" \
|
|
|
|
"#{?#{&&:#{window_bell_flag}," \
|
|
|
|
"#{!=:#{window-status-bell-style},default}}, " \
|
|
|
|
"#{window-status-bell-style}," \
|
2019-04-02 18:41:24 +00:00
|
|
|
"#{?#{&&:#{||:#{window_activity_flag}," \
|
|
|
|
"#{window_silence_flag}}," \
|
2019-03-19 21:09:51 +00:00
|
|
|
"#{!=:" \
|
|
|
|
"#{window-status-activity-style}," \
|
|
|
|
"default}}, " \
|
|
|
|
"#{window-status-activity-style}," \
|
2019-03-18 20:53:33 +00:00
|
|
|
"}" \
|
2019-03-19 21:09:51 +00:00
|
|
|
"}" \
|
2019-03-18 20:53:33 +00:00
|
|
|
"]" \
|
|
|
|
"#{T:window-status-current-format}" \
|
|
|
|
"#[norange list=on default]" \
|
|
|
|
"#{?window_end_flag,,#{window-status-separator}}" \
|
|
|
|
"}" \
|
|
|
|
"#[nolist align=right range=right #{status-right-style}]" \
|
|
|
|
"#{T;=/#{status-right-length}:status-right}#[norange default]"
|
|
|
|
#define OPTIONS_TABLE_STATUS_FORMAT2 \
|
|
|
|
"#[align=centre]#{P:#{?pane_active,#[reverse],}" \
|
|
|
|
"#{pane_index}[#{pane_width}x#{pane_height}]#[default] }"
|
|
|
|
static const char *options_table_status_format_default[] = {
|
|
|
|
OPTIONS_TABLE_STATUS_FORMAT1, OPTIONS_TABLE_STATUS_FORMAT2, NULL
|
|
|
|
};
|
|
|
|
|
2019-04-26 11:38:51 +00:00
|
|
|
/* Helper for hook options. */
|
|
|
|
#define OPTIONS_TABLE_HOOK(hook_name, default_value) \
|
|
|
|
{ .name = hook_name, \
|
|
|
|
.type = OPTIONS_TABLE_COMMAND, \
|
|
|
|
.scope = OPTIONS_TABLE_SESSION, \
|
|
|
|
.flags = OPTIONS_TABLE_IS_ARRAY|OPTIONS_TABLE_IS_HOOK, \
|
|
|
|
.default_str = default_value, \
|
|
|
|
.separator = "" \
|
|
|
|
}
|
|
|
|
|
2017-01-15 20:48:41 +00:00
|
|
|
/* Top-level options. */
|
2015-11-20 12:01:19 +00:00
|
|
|
const struct options_table_entry options_table[] = {
|
2019-04-26 11:38:51 +00:00
|
|
|
/* Server options. */
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "buffer-limit",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SERVER,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 1,
|
|
|
|
.maximum = INT_MAX,
|
Rewrite of choose mode, both to simplify and tidy the code and to add
some modern features.
Now the common code is in mode-tree.c, which provides an API used by the
three modes now separated into window-{buffer,client,tree}.c. Buffer
mode shows buffers, client mode clients and tree mode a tree of
sessions, windows and panes.
Each mode has a common set of key bindings plus a few that are specific
to the mode. Other changes are:
- each mode has a preview pane: for buffers this is the buffer content
(very useful), for others it is a preview of the pane;
- items may be sorted in different ways ('O' key);
- multiple items may be tagged and an operation applied to all of them
(for example, to delete multiple buffers at once);
- in tree mode a command may be run on the selected item (session,
window, pane) or on tagged items (key ':');
- displayed items may be filtered in tree mode by using a format (this
is used to implement find-window) (key 'f');
- the custom format (-F) for the display is no longer available;
- shortcut keys change from 0-9, a-z, A-Z which was always a bit weird
with keys used for other uses to 0-9, M-a to M-z.
Now that the code is simpler, other improvements will come later.
Primary key bindings for each mode are documented under the commands in
the man page (choose-buffer, choose-client, choose-tree).
Parts written by Thomas Adam.
2017-05-30 21:44:59 +00:00
|
|
|
.default_num = 50
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
2017-01-24 19:59:19 +00:00
|
|
|
{ .name = "command-alias",
|
2019-04-23 20:36:55 +00:00
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2017-01-24 19:59:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SERVER,
|
2019-04-23 20:36:55 +00:00
|
|
|
.flags = OPTIONS_TABLE_IS_ARRAY,
|
2017-01-24 19:59:19 +00:00
|
|
|
.default_str = "split-pane=split-window,"
|
|
|
|
"splitp=split-window,"
|
|
|
|
"server-info=show-messages -JT,"
|
Rewrite of choose mode, both to simplify and tidy the code and to add
some modern features.
Now the common code is in mode-tree.c, which provides an API used by the
three modes now separated into window-{buffer,client,tree}.c. Buffer
mode shows buffers, client mode clients and tree mode a tree of
sessions, windows and panes.
Each mode has a common set of key bindings plus a few that are specific
to the mode. Other changes are:
- each mode has a preview pane: for buffers this is the buffer content
(very useful), for others it is a preview of the pane;
- items may be sorted in different ways ('O' key);
- multiple items may be tagged and an operation applied to all of them
(for example, to delete multiple buffers at once);
- in tree mode a command may be run on the selected item (session,
window, pane) or on tagged items (key ':');
- displayed items may be filtered in tree mode by using a format (this
is used to implement find-window) (key 'f');
- the custom format (-F) for the display is no longer available;
- shortcut keys change from 0-9, a-z, A-Z which was always a bit weird
with keys used for other uses to 0-9, M-a to M-z.
Now that the code is simpler, other improvements will come later.
Primary key bindings for each mode are documented under the commands in
the man page (choose-buffer, choose-client, choose-tree).
Parts written by Thomas Adam.
2017-05-30 21:44:59 +00:00
|
|
|
"info=show-messages -JT,"
|
|
|
|
"choose-window=choose-tree -w,"
|
|
|
|
"choose-session=choose-tree -s",
|
2017-01-24 19:59:19 +00:00
|
|
|
.separator = ","
|
|
|
|
},
|
|
|
|
|
2015-04-29 15:59:08 +00:00
|
|
|
{ .name = "default-terminal",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SERVER,
|
2015-04-29 15:59:08 +00:00
|
|
|
.default_str = "screen"
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "escape-time",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SERVER,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 500
|
|
|
|
},
|
|
|
|
|
2018-02-22 10:54:51 +00:00
|
|
|
{ .name = "exit-empty",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
|
|
|
.scope = OPTIONS_TABLE_SERVER,
|
|
|
|
.default_num = 1
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "exit-unattached",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SERVER,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
2013-06-23 13:10:46 +00:00
|
|
|
{ .name = "focus-events",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SERVER,
|
2013-06-23 13:10:46 +00:00
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
2015-07-20 15:50:04 +00:00
|
|
|
{ .name = "history-file",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SERVER,
|
2015-11-12 08:19:18 +00:00
|
|
|
.default_str = ""
|
2015-07-20 15:50:04 +00:00
|
|
|
},
|
|
|
|
|
2014-03-31 21:41:35 +00:00
|
|
|
{ .name = "message-limit",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SERVER,
|
2014-03-31 21:41:35 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 100
|
|
|
|
},
|
|
|
|
|
2011-05-18 20:24:29 +00:00
|
|
|
{ .name = "set-clipboard",
|
2017-06-03 17:43:01 +00:00
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SERVER,
|
2017-06-03 17:43:01 +00:00
|
|
|
.choices = options_table_set_clipboard_list,
|
2011-05-18 20:24:29 +00:00
|
|
|
.default_num = 1
|
|
|
|
},
|
|
|
|
|
2014-02-23 00:53:06 +00:00
|
|
|
{ .name = "terminal-overrides",
|
2019-04-23 20:36:55 +00:00
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SERVER,
|
2019-04-23 20:36:55 +00:00
|
|
|
.flags = OPTIONS_TABLE_IS_ARRAY,
|
2015-09-25 23:30:24 +00:00
|
|
|
.default_str = "xterm*:XT:Ms=\\E]52;%p1%s;%p2%s\\007"
|
2017-05-29 20:41:29 +00:00
|
|
|
":Cs=\\E]12;%p1%s\\007:Cr=\\E]112\\007"
|
2017-01-24 20:05:15 +00:00
|
|
|
":Ss=\\E[%p1%d q:Se=\\E[2 q,screen*:XT",
|
|
|
|
.separator = ","
|
2014-02-23 00:53:06 +00:00
|
|
|
},
|
|
|
|
|
2017-06-23 15:36:52 +00:00
|
|
|
{ .name = "user-keys",
|
2019-04-23 20:36:55 +00:00
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2017-06-23 15:36:52 +00:00
|
|
|
.scope = OPTIONS_TABLE_SERVER,
|
2019-04-23 20:36:55 +00:00
|
|
|
.flags = OPTIONS_TABLE_IS_ARRAY,
|
2017-06-23 15:36:52 +00:00
|
|
|
.default_str = "",
|
|
|
|
.separator = ","
|
|
|
|
},
|
|
|
|
|
2019-04-26 11:38:51 +00:00
|
|
|
/* Session options. */
|
2017-07-26 16:14:08 +00:00
|
|
|
{ .name = "activity-action",
|
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
|
|
|
.choices = options_table_bell_action_list,
|
2017-08-16 11:46:08 +00:00
|
|
|
.default_num = ALERT_OTHER
|
2017-07-26 16:14:08 +00:00
|
|
|
},
|
|
|
|
|
2013-01-15 22:55:29 +00:00
|
|
|
{ .name = "assume-paste-time",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2013-01-15 22:55:29 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 1,
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "base-index",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "bell-action",
|
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.choices = options_table_bell_action_list,
|
2017-08-16 11:46:08 +00:00
|
|
|
.default_num = ALERT_ANY
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "default-command",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_str = ""
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "default-shell",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_str = _PATH_BSHELL
|
|
|
|
},
|
|
|
|
|
Support for windows larger than visible on the attached client. This has
been a limitation for a long time.
There are two new options, window-size and default-size, and a new
command, resize-window. The force-width and force-height options and the
session_width and session_height formats have been removed.
The new window-size option tells tmux how to work out the size of
windows: largest means it picks the size of the largest session,
smallest the smallest session (similar to the old behaviour) and manual
means that it does not automatically resize windows. The default is
currently largest but this may change. aggressive-resize modifies the
choice of session for largest and smallest as it did before.
If a window is in a session attached to a client that is too small, only
part of the window is shown. tmux attempts to keep the cursor visible,
so the part of the window displayed is changed as the cursor moves (with
a small delay, to try and avoid excess redrawing when applications
redraw status lines or similar that are not currently visible). The
offset of the visible portion of the window is shown in status-right.
Drawing windows which are larger than the client is not as efficient as
those which fit, particularly when the cursor moves, so it is
recommended to avoid using this on slow machines or networks (set
window-size to smallest or manual).
The resize-window command can be used to resize a window manually. If it
is used, the window-size option is automatically set to manual for the
window (undo this with "setw -u window-size"). resize-window works in a
similar way to resize-pane (-U -D -L -R -x -y flags) but also has -a and
-A flags. -a sets the window to the size of the smallest client (what it
would be if window-size was smallest) and -A the largest.
For the same behaviour as force-width or force-height, use resize-window
-x or -y, and "setw -u window-size" to revert to automatic sizing..
If the global window-size option is set to manual, the default-size
option is used for new windows. If -x or -y is used with new-session,
that sets the default-size option for the new session.
The maximum size of a window is 10000x10000. But expect applications to
complain and much higher memory use if making a window excessively
big. The minimum size is the size required for the current layout
including borders.
The refresh-client command can be used to pan around a window, -U -D -L
-R moves up, down, left or right and -c returns to automatic cursor
tracking. The position is reset when the current window is changed.
2018-10-18 08:38:01 +00:00
|
|
|
{ .name = "default-size",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
|
|
|
.pattern = "[0-9]*x[0-9]*",
|
|
|
|
.default_str = "80x24"
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "destroy-unattached",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "detach-on-destroy",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 1
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "display-panes-active-colour",
|
|
|
|
.type = OPTIONS_TABLE_COLOUR,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 1
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "display-panes-colour",
|
|
|
|
.type = OPTIONS_TABLE_COLOUR,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 4
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "display-panes-time",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 1,
|
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 1000
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "display-time",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2015-11-22 18:28:01 +00:00
|
|
|
.minimum = 0,
|
2011-01-01 16:51:21 +00:00
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 750
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "history-limit",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 0,
|
2011-01-13 13:38:57 +00:00
|
|
|
.maximum = INT_MAX,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 2000
|
|
|
|
},
|
|
|
|
|
2015-12-12 18:32:24 +00:00
|
|
|
{ .name = "key-table",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
|
|
|
.default_str = "root"
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "lock-after-time",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "lock-command",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_str = "lock -np"
|
|
|
|
},
|
|
|
|
|
2014-01-28 23:07:09 +00:00
|
|
|
{ .name = "message-command-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_str = "bg=black,fg=yellow"
|
2011-11-05 09:06:31 +00:00
|
|
|
},
|
|
|
|
|
2014-01-28 23:07:09 +00:00
|
|
|
{ .name = "message-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_str = "bg=yellow,fg=black"
|
|
|
|
},
|
|
|
|
|
2015-04-19 21:34:21 +00:00
|
|
|
{ .name = "mouse",
|
2011-04-18 19:49:05 +00:00
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-04-18 19:49:05 +00:00
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "prefix",
|
2012-01-21 08:40:09 +00:00
|
|
|
.type = OPTIONS_TABLE_KEY,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2012-01-21 08:40:09 +00:00
|
|
|
.default_num = '\002',
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "prefix2",
|
|
|
|
.type = OPTIONS_TABLE_KEY,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2012-01-21 08:40:09 +00:00
|
|
|
.default_num = KEYC_NONE,
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
2012-04-29 17:20:01 +00:00
|
|
|
{ .name = "renumber-windows",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2012-04-29 17:20:01 +00:00
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "repeat-time",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = SHRT_MAX,
|
|
|
|
.default_num = 500
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "set-titles",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "set-titles-string",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2015-05-12 15:29:29 +00:00
|
|
|
.default_str = "#S:#I:#W - \"#T\" #{session_alerts}"
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
2017-07-26 16:14:08 +00:00
|
|
|
{ .name = "silence-action",
|
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
|
|
|
.choices = options_table_bell_action_list,
|
2017-08-16 11:46:08 +00:00
|
|
|
.default_num = ALERT_OTHER
|
2017-07-26 16:14:08 +00:00
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "status",
|
2019-03-18 20:53:33 +00:00
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2019-03-18 20:53:33 +00:00
|
|
|
.choices = options_table_status_list,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 1
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "status-bg",
|
|
|
|
.type = OPTIONS_TABLE_COLOUR,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_num = 2,
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "status-fg",
|
|
|
|
.type = OPTIONS_TABLE_COLOUR,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_num = 0,
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
2019-03-18 20:53:33 +00:00
|
|
|
{ .name = "status-format",
|
2019-04-23 20:36:55 +00:00
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2019-03-18 20:53:33 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2019-04-23 20:36:55 +00:00
|
|
|
.flags = OPTIONS_TABLE_IS_ARRAY,
|
2019-03-18 20:53:33 +00:00
|
|
|
.default_arr = options_table_status_format_default,
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "status-interval",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 15
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "status-justify",
|
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.choices = options_table_status_justify_list,
|
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "status-keys",
|
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.choices = options_table_status_keys_list,
|
|
|
|
.default_num = MODEKEY_EMACS
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "status-left",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2014-11-05 23:15:11 +00:00
|
|
|
.default_str = "[#S] "
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "status-left-length",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = SHRT_MAX,
|
|
|
|
.default_num = 10
|
|
|
|
},
|
|
|
|
|
2014-01-28 23:07:09 +00:00
|
|
|
{ .name = "status-left-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_str = "default"
|
|
|
|
},
|
|
|
|
|
2012-01-29 09:37:02 +00:00
|
|
|
{ .name = "status-position",
|
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2012-01-29 09:37:02 +00:00
|
|
|
.choices = options_table_status_position_list,
|
|
|
|
.default_num = 1
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "status-right",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
Support for windows larger than visible on the attached client. This has
been a limitation for a long time.
There are two new options, window-size and default-size, and a new
command, resize-window. The force-width and force-height options and the
session_width and session_height formats have been removed.
The new window-size option tells tmux how to work out the size of
windows: largest means it picks the size of the largest session,
smallest the smallest session (similar to the old behaviour) and manual
means that it does not automatically resize windows. The default is
currently largest but this may change. aggressive-resize modifies the
choice of session for largest and smallest as it did before.
If a window is in a session attached to a client that is too small, only
part of the window is shown. tmux attempts to keep the cursor visible,
so the part of the window displayed is changed as the cursor moves (with
a small delay, to try and avoid excess redrawing when applications
redraw status lines or similar that are not currently visible). The
offset of the visible portion of the window is shown in status-right.
Drawing windows which are larger than the client is not as efficient as
those which fit, particularly when the cursor moves, so it is
recommended to avoid using this on slow machines or networks (set
window-size to smallest or manual).
The resize-window command can be used to resize a window manually. If it
is used, the window-size option is automatically set to manual for the
window (undo this with "setw -u window-size"). resize-window works in a
similar way to resize-pane (-U -D -L -R -x -y flags) but also has -a and
-A flags. -a sets the window to the size of the smallest client (what it
would be if window-size was smallest) and -A the largest.
For the same behaviour as force-width or force-height, use resize-window
-x or -y, and "setw -u window-size" to revert to automatic sizing..
If the global window-size option is set to manual, the default-size
option is used for new windows. If -x or -y is used with new-session,
that sets the default-size option for the new session.
The maximum size of a window is 10000x10000. But expect applications to
complain and much higher memory use if making a window excessively
big. The minimum size is the size required for the current layout
including borders.
The refresh-client command can be used to pan around a window, -U -D -L
-R moves up, down, left or right and -c returns to automatic cursor
tracking. The position is reset when the current window is changed.
2018-10-18 08:38:01 +00:00
|
|
|
.default_str = "#{?window_bigger,"
|
|
|
|
"[#{window_offset_x}#,#{window_offset_y}] ,}"
|
|
|
|
"\"#{=21:pane_title}\" %H:%M %d-%b-%y"
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "status-right-length",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = SHRT_MAX,
|
|
|
|
.default_num = 40
|
|
|
|
},
|
|
|
|
|
2014-01-28 23:07:09 +00:00
|
|
|
{ .name = "status-right-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_str = "default"
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "status-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_str = "bg=green,fg=black"
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "update-environment",
|
2019-04-23 20:36:55 +00:00
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2019-04-23 20:36:55 +00:00
|
|
|
.flags = OPTIONS_TABLE_IS_ARRAY,
|
2018-04-23 14:03:06 +00:00
|
|
|
.default_str = "DISPLAY KRB5CCNAME SSH_ASKPASS SSH_AUTH_SOCK "
|
|
|
|
"SSH_AGENT_PID SSH_CONNECTION WINDOWID XAUTHORITY"
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "visual-activity",
|
2017-07-26 16:14:08 +00:00
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2017-07-26 16:14:08 +00:00
|
|
|
.choices = options_table_visual_bell_list,
|
|
|
|
.default_num = VISUAL_OFF
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "visual-bell",
|
2017-07-26 16:14:08 +00:00
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2017-07-26 16:14:08 +00:00
|
|
|
.choices = options_table_visual_bell_list,
|
|
|
|
.default_num = VISUAL_OFF
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "visual-silence",
|
2017-07-26 16:14:08 +00:00
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2017-07-26 16:14:08 +00:00
|
|
|
.choices = options_table_visual_bell_list,
|
|
|
|
.default_num = VISUAL_OFF
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
2011-11-15 23:24:04 +00:00
|
|
|
{ .name = "word-separators",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_SESSION,
|
2011-11-15 23:24:04 +00:00
|
|
|
.default_str = " -_@"
|
|
|
|
},
|
|
|
|
|
2019-04-26 11:38:51 +00:00
|
|
|
/* Window options. */
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "aggressive-resize",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
2012-01-20 19:15:40 +00:00
|
|
|
{ .name = "allow-rename",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2017-10-25 14:14:52 +00:00
|
|
|
.default_num = 0
|
2012-01-20 19:15:40 +00:00
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "alternate-screen",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 1
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "automatic-rename",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 1
|
|
|
|
},
|
|
|
|
|
2013-10-10 11:56:50 +00:00
|
|
|
{ .name = "automatic-rename-format",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2014-04-17 12:57:28 +00:00
|
|
|
.default_str = "#{?pane_in_mode,[tmux],#{pane_current_command}}"
|
2017-05-29 20:41:29 +00:00
|
|
|
"#{?pane_dead,[dead],}"
|
2013-10-10 11:56:50 +00:00
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "clock-mode-colour",
|
|
|
|
.type = OPTIONS_TABLE_COLOUR,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 4
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "clock-mode-style",
|
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.choices = options_table_clock_mode_style_list,
|
|
|
|
.default_num = 1
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "main-pane-height",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 1,
|
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 24
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "main-pane-width",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 1,
|
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 80
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "mode-keys",
|
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.choices = options_table_mode_keys_list,
|
|
|
|
.default_num = MODEKEY_EMACS
|
|
|
|
},
|
|
|
|
|
2014-01-28 23:07:09 +00:00
|
|
|
{ .name = "mode-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_str = "bg=yellow,fg=black"
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "monitor-activity",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
2017-08-17 08:37:38 +00:00
|
|
|
{ .name = "monitor-bell",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
|
|
|
.default_num = 1
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "monitor-silence",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "other-pane-height",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "other-pane-width",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = INT_MAX,
|
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
2015-02-06 15:09:34 +00:00
|
|
|
{ .name = "pane-active-border-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2015-02-06 15:09:34 +00:00
|
|
|
.default_str = "fg=green"
|
|
|
|
},
|
|
|
|
|
2011-08-24 10:29:57 +00:00
|
|
|
{ .name = "pane-base-index",
|
|
|
|
.type = OPTIONS_TABLE_NUMBER,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-08-24 10:29:57 +00:00
|
|
|
.minimum = 0,
|
|
|
|
.maximum = USHRT_MAX,
|
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
2016-04-29 15:00:48 +00:00
|
|
|
{ .name = "pane-border-format",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2016-05-04 21:29:47 +00:00
|
|
|
.default_str = "#{?pane_active,#[reverse],}#{pane_index}#[default] "
|
2017-05-29 20:41:29 +00:00
|
|
|
"\"#{pane_title}\""
|
2016-04-29 15:00:48 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "pane-border-status",
|
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
|
|
|
.choices = options_table_pane_status_list,
|
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
2015-02-06 15:09:34 +00:00
|
|
|
{ .name = "pane-border-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2015-02-06 15:09:34 +00:00
|
|
|
.default_str = "default"
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "remain-on-exit",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "synchronize-panes",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2011-01-01 16:51:21 +00:00
|
|
|
.default_num = 0
|
|
|
|
},
|
|
|
|
|
2015-04-19 21:05:27 +00:00
|
|
|
{ .name = "window-active-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2015-04-19 21:05:27 +00:00
|
|
|
.default_str = "default"
|
|
|
|
},
|
|
|
|
|
Support for windows larger than visible on the attached client. This has
been a limitation for a long time.
There are two new options, window-size and default-size, and a new
command, resize-window. The force-width and force-height options and the
session_width and session_height formats have been removed.
The new window-size option tells tmux how to work out the size of
windows: largest means it picks the size of the largest session,
smallest the smallest session (similar to the old behaviour) and manual
means that it does not automatically resize windows. The default is
currently largest but this may change. aggressive-resize modifies the
choice of session for largest and smallest as it did before.
If a window is in a session attached to a client that is too small, only
part of the window is shown. tmux attempts to keep the cursor visible,
so the part of the window displayed is changed as the cursor moves (with
a small delay, to try and avoid excess redrawing when applications
redraw status lines or similar that are not currently visible). The
offset of the visible portion of the window is shown in status-right.
Drawing windows which are larger than the client is not as efficient as
those which fit, particularly when the cursor moves, so it is
recommended to avoid using this on slow machines or networks (set
window-size to smallest or manual).
The resize-window command can be used to resize a window manually. If it
is used, the window-size option is automatically set to manual for the
window (undo this with "setw -u window-size"). resize-window works in a
similar way to resize-pane (-U -D -L -R -x -y flags) but also has -a and
-A flags. -a sets the window to the size of the smallest client (what it
would be if window-size was smallest) and -A the largest.
For the same behaviour as force-width or force-height, use resize-window
-x or -y, and "setw -u window-size" to revert to automatic sizing..
If the global window-size option is set to manual, the default-size
option is used for new windows. If -x or -y is used with new-session,
that sets the default-size option for the new session.
The maximum size of a window is 10000x10000. But expect applications to
complain and much higher memory use if making a window excessively
big. The minimum size is the size required for the current layout
including borders.
The refresh-client command can be used to pan around a window, -U -D -L
-R moves up, down, left or right and -c returns to automatic cursor
tracking. The position is reset when the current window is changed.
2018-10-18 08:38:01 +00:00
|
|
|
{ .name = "window-size",
|
|
|
|
.type = OPTIONS_TABLE_CHOICE,
|
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
|
|
|
.choices = options_table_window_size_list,
|
2018-10-25 15:13:38 +00:00
|
|
|
.default_num = WINDOW_SIZE_SMALLEST
|
Support for windows larger than visible on the attached client. This has
been a limitation for a long time.
There are two new options, window-size and default-size, and a new
command, resize-window. The force-width and force-height options and the
session_width and session_height formats have been removed.
The new window-size option tells tmux how to work out the size of
windows: largest means it picks the size of the largest session,
smallest the smallest session (similar to the old behaviour) and manual
means that it does not automatically resize windows. The default is
currently largest but this may change. aggressive-resize modifies the
choice of session for largest and smallest as it did before.
If a window is in a session attached to a client that is too small, only
part of the window is shown. tmux attempts to keep the cursor visible,
so the part of the window displayed is changed as the cursor moves (with
a small delay, to try and avoid excess redrawing when applications
redraw status lines or similar that are not currently visible). The
offset of the visible portion of the window is shown in status-right.
Drawing windows which are larger than the client is not as efficient as
those which fit, particularly when the cursor moves, so it is
recommended to avoid using this on slow machines or networks (set
window-size to smallest or manual).
The resize-window command can be used to resize a window manually. If it
is used, the window-size option is automatically set to manual for the
window (undo this with "setw -u window-size"). resize-window works in a
similar way to resize-pane (-U -D -L -R -x -y flags) but also has -a and
-A flags. -a sets the window to the size of the smallest client (what it
would be if window-size was smallest) and -A the largest.
For the same behaviour as force-width or force-height, use resize-window
-x or -y, and "setw -u window-size" to revert to automatic sizing..
If the global window-size option is set to manual, the default-size
option is used for new windows. If -x or -y is used with new-session,
that sets the default-size option for the new session.
The maximum size of a window is 10000x10000. But expect applications to
complain and much higher memory use if making a window excessively
big. The minimum size is the size required for the current layout
including borders.
The refresh-client command can be used to pan around a window, -U -D -L
-R moves up, down, left or right and -c returns to automatic cursor
tracking. The position is reset when the current window is changed.
2018-10-18 08:38:01 +00:00
|
|
|
},
|
|
|
|
|
2015-04-19 21:05:27 +00:00
|
|
|
{ .name = "window-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2015-04-19 21:05:27 +00:00
|
|
|
.default_str = "default"
|
|
|
|
},
|
|
|
|
|
2014-01-28 23:07:09 +00:00
|
|
|
{ .name = "window-status-activity-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_str = "reverse"
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "window-status-bell-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_str = "reverse"
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "window-status-current-format",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2015-05-06 08:35:39 +00:00
|
|
|
.default_str = "#I:#W#{?window_flags,#{window_flags}, }"
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
2014-01-28 23:07:09 +00:00
|
|
|
{ .name = "window-status-current-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_str = "default"
|
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "window-status-format",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2015-05-06 08:35:39 +00:00
|
|
|
.default_str = "#I:#W#{?window_flags,#{window_flags}, }"
|
2014-01-28 23:07:09 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
{ .name = "window-status-last-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_str = "default"
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
2012-04-23 22:23:14 +00:00
|
|
|
{ .name = "window-status-separator",
|
|
|
|
.type = OPTIONS_TABLE_STRING,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2012-04-23 22:23:14 +00:00
|
|
|
.default_str = " "
|
|
|
|
},
|
|
|
|
|
2014-01-28 23:07:09 +00:00
|
|
|
{ .name = "window-status-style",
|
|
|
|
.type = OPTIONS_TABLE_STYLE,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2014-01-28 23:07:09 +00:00
|
|
|
.default_str = "default"
|
|
|
|
},
|
|
|
|
|
2012-03-17 21:40:53 +00:00
|
|
|
{ .name = "wrap-search",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2012-03-17 21:40:53 +00:00
|
|
|
.default_num = 1
|
|
|
|
},
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = "xterm-keys",
|
|
|
|
.type = OPTIONS_TABLE_FLAG,
|
2015-11-20 12:01:19 +00:00
|
|
|
.scope = OPTIONS_TABLE_WINDOW,
|
2016-12-30 13:49:34 +00:00
|
|
|
.default_num = 1
|
2011-01-01 16:51:21 +00:00
|
|
|
},
|
|
|
|
|
2019-04-26 11:38:51 +00:00
|
|
|
/* Hook options. */
|
|
|
|
OPTIONS_TABLE_HOOK("after-bind-key", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-capture-pane", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-copy-mode", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-display-message", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-display-panes", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-list-buffers", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-list-clients", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-list-keys", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-list-panes", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-list-sessions", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-list-windows", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-load-buffer", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-lock-server", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-new-session", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-new-window", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-paste-buffer", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-pipe-pane", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-queue", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-refresh-client", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-rename-session", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-rename-window", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-resize-pane", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-resize-window", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-save-buffer", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-select-layout", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-select-pane", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-select-window", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-send-keys", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-set-buffer", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-set-environment", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-set-hook", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-set-option", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-show-environment", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-show-messages", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-show-options", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-split-window", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("after-unbind-key", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("alert-activity", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("alert-bell", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("alert-silence", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("client-attached", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("client-detached", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("client-resized", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("client-session-changed", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("pane-died", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("pane-exited", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("pane-focus-in", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("pane-focus-out", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("pane-mode-changed", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("pane-set-clipboard", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("session-closed", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("session-created", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("session-renamed", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("session-window-changed", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("window-layout-changed", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("window-linked", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("window-pane-changed", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("window-renamed", ""),
|
|
|
|
OPTIONS_TABLE_HOOK("window-unlinked", ""),
|
|
|
|
|
2011-01-01 16:51:21 +00:00
|
|
|
{ .name = NULL }
|
|
|
|
};
|