mirror of
https://github.com/tmux/tmux.git
synced 2025-09-01 20:57:00 +00:00
Add a customize mode where options may be browsed and changed, includes adding
a brief description of each option. Bound to "C" by default.
This commit is contained in:
358
options-table.c
358
options-table.c
@ -102,9 +102,9 @@ static const char *options_table_window_size_list[] = {
|
||||
"," \
|
||||
"#[range=window|#{window_index} list=focus " \
|
||||
"#{?#{!=:#{window-status-current-style},default}," \
|
||||
"#{window-status-current-style}," \
|
||||
"#{window-status-style}" \
|
||||
"}" \
|
||||
"#{window-status-current-style}," \
|
||||
"#{window-status-style}" \
|
||||
"}" \
|
||||
"#{?#{&&:#{window_last_flag}," \
|
||||
"#{!=:#{window-status-last-style},default}}, " \
|
||||
"#{window-status-last-style}," \
|
||||
@ -174,6 +174,7 @@ const struct options_table_entry options_table[] = {
|
||||
.type = OPTIONS_TABLE_KEY,
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.default_num = '\177',
|
||||
.text = "The key to send for backspace."
|
||||
},
|
||||
|
||||
{ .name = "buffer-limit",
|
||||
@ -181,7 +182,9 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.minimum = 1,
|
||||
.maximum = INT_MAX,
|
||||
.default_num = 50
|
||||
.default_num = 50,
|
||||
.text = "The maximum number of automatic buffers. "
|
||||
"When this is reached, the oldest buffer is deleted."
|
||||
},
|
||||
|
||||
{ .name = "command-alias",
|
||||
@ -194,25 +197,31 @@ const struct options_table_entry options_table[] = {
|
||||
"info=show-messages -JT,"
|
||||
"choose-window=choose-tree -w,"
|
||||
"choose-session=choose-tree -s",
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Array of command aliases. "
|
||||
"Each entry is an alias and a command separated by '='."
|
||||
},
|
||||
|
||||
{ .name = "copy-command",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.default_str = ""
|
||||
.default_str = "",
|
||||
.text = "Shell command run when text is copied. "
|
||||
"If empty, no command is run."
|
||||
},
|
||||
|
||||
{ .name = "default-terminal",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.default_str = "screen"
|
||||
.default_str = "screen",
|
||||
.text = "Default for the 'TERM' environment variable."
|
||||
},
|
||||
|
||||
{ .name = "editor",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.default_str = _PATH_VI
|
||||
.default_str = _PATH_VI,
|
||||
.text = "Editor run to edit files."
|
||||
},
|
||||
|
||||
{ .name = "escape-time",
|
||||
@ -220,31 +229,38 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.minimum = 0,
|
||||
.maximum = INT_MAX,
|
||||
.default_num = 500
|
||||
.default_num = 500,
|
||||
.text = "Time to wait before assuming a key is Escape."
|
||||
},
|
||||
|
||||
{ .name = "exit-empty",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.default_num = 1
|
||||
.default_num = 1,
|
||||
.text = "Whether the server should exit if there are no sessions."
|
||||
},
|
||||
|
||||
{ .name = "exit-unattached",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Whether the server should exit if there are no attached "
|
||||
"clients."
|
||||
},
|
||||
|
||||
{ .name = "focus-events",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Whether to send focus events to applications."
|
||||
},
|
||||
|
||||
{ .name = "history-file",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.default_str = ""
|
||||
.default_str = "",
|
||||
.text = "Location of the command prompt history file. "
|
||||
"Empty does not write a history file."
|
||||
},
|
||||
|
||||
{ .name = "message-limit",
|
||||
@ -252,14 +268,18 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.minimum = 0,
|
||||
.maximum = INT_MAX,
|
||||
.default_num = 1000
|
||||
.default_num = 1000,
|
||||
.text = "Maximum number of server messages to keep."
|
||||
},
|
||||
|
||||
{ .name = "set-clipboard",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.choices = options_table_set_clipboard_list,
|
||||
.default_num = 1
|
||||
.default_num = 1,
|
||||
.text = "Whether to attempt to set the system clipboard ('on' or "
|
||||
"'external') and whether to allow applications to create "
|
||||
"paste buffers with an escape sequence ('on' only)."
|
||||
},
|
||||
|
||||
{ .name = "terminal-overrides",
|
||||
@ -267,7 +287,8 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.flags = OPTIONS_TABLE_IS_ARRAY,
|
||||
.default_str = "",
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "List of terminal capabilities overrides."
|
||||
},
|
||||
|
||||
{ .name = "terminal-features",
|
||||
@ -275,8 +296,10 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.flags = OPTIONS_TABLE_IS_ARRAY,
|
||||
.default_str = "xterm*:clipboard:ccolour:cstyle:title,"
|
||||
"screen*:title",
|
||||
.separator = ","
|
||||
"screen*:title",
|
||||
.separator = ",",
|
||||
.text = "List of terminal features, used if they cannot be "
|
||||
"automatically detected."
|
||||
},
|
||||
|
||||
{ .name = "user-keys",
|
||||
@ -284,7 +307,10 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SERVER,
|
||||
.flags = OPTIONS_TABLE_IS_ARRAY,
|
||||
.default_str = "",
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "User key assignments. "
|
||||
"Each sequence in the list is translated into a key: "
|
||||
"'User0', 'User1' and so on."
|
||||
},
|
||||
|
||||
/* Session options. */
|
||||
@ -292,7 +318,8 @@ const struct options_table_entry options_table[] = {
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.choices = options_table_bell_action_list,
|
||||
.default_num = ALERT_OTHER
|
||||
.default_num = ALERT_OTHER,
|
||||
.text = "Action to take on an activity alert."
|
||||
},
|
||||
|
||||
{ .name = "assume-paste-time",
|
||||
@ -301,6 +328,9 @@ const struct options_table_entry options_table[] = {
|
||||
.minimum = 0,
|
||||
.maximum = INT_MAX,
|
||||
.default_num = 1,
|
||||
.unit = "milliseconds",
|
||||
.text = "Maximum time between input to assume it pasting rather "
|
||||
"than typing."
|
||||
},
|
||||
|
||||
{ .name = "base-index",
|
||||
@ -308,57 +338,69 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.minimum = 0,
|
||||
.maximum = INT_MAX,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Default index of the first window in each session."
|
||||
},
|
||||
|
||||
{ .name = "bell-action",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.choices = options_table_bell_action_list,
|
||||
.default_num = ALERT_ANY
|
||||
.default_num = ALERT_ANY,
|
||||
.text = "Action to take on a bell alert."
|
||||
},
|
||||
|
||||
{ .name = "default-command",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = ""
|
||||
.default_str = "",
|
||||
.text = "Default command to run in new panes. If empty, a shell is "
|
||||
"started."
|
||||
},
|
||||
|
||||
{ .name = "default-shell",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = _PATH_BSHELL
|
||||
.default_str = _PATH_BSHELL,
|
||||
.text = "Location of default shell."
|
||||
},
|
||||
|
||||
{ .name = "default-size",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.pattern = "[0-9]*x[0-9]*",
|
||||
.default_str = "80x24"
|
||||
.default_str = "80x24",
|
||||
.text = "Initial size of new sessions."
|
||||
},
|
||||
|
||||
{ .name = "destroy-unattached",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Whether to destroy sessions when they have no attached "
|
||||
"clients."
|
||||
},
|
||||
|
||||
{ .name = "detach-on-destroy",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_num = 1
|
||||
.default_num = 1,
|
||||
.text = "Whether to detach when a session is destroyed, or switch "
|
||||
"the client to another session if any exist."
|
||||
},
|
||||
|
||||
{ .name = "display-panes-active-colour",
|
||||
.type = OPTIONS_TABLE_COLOUR,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_num = 1
|
||||
.default_num = 1,
|
||||
.text = "Colour of the active pane for 'display-panes'."
|
||||
},
|
||||
|
||||
{ .name = "display-panes-colour",
|
||||
.type = OPTIONS_TABLE_COLOUR,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_num = 4
|
||||
.default_num = 4,
|
||||
.text = "Colour of not active panes for 'display-panes'."
|
||||
},
|
||||
|
||||
{ .name = "display-panes-time",
|
||||
@ -366,7 +408,9 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.minimum = 1,
|
||||
.maximum = INT_MAX,
|
||||
.default_num = 1000
|
||||
.default_num = 1000,
|
||||
.unit = "milliseconds",
|
||||
.text = "Time for which 'display-panes' should show pane numbers."
|
||||
},
|
||||
|
||||
{ .name = "display-time",
|
||||
@ -374,7 +418,9 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.minimum = 0,
|
||||
.maximum = INT_MAX,
|
||||
.default_num = 750
|
||||
.default_num = 750,
|
||||
.unit = "milliseconds",
|
||||
.text = "Time for which status line messages should appear."
|
||||
},
|
||||
|
||||
{ .name = "history-limit",
|
||||
@ -382,13 +428,19 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.minimum = 0,
|
||||
.maximum = INT_MAX,
|
||||
.default_num = 2000
|
||||
.default_num = 2000,
|
||||
.unit = "lines",
|
||||
.text = "Maximum number of lines to keep in the history for each "
|
||||
"pane. "
|
||||
"If changed, the new value applies only to new panes."
|
||||
},
|
||||
|
||||
{ .name = "key-table",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = "root"
|
||||
.default_str = "root",
|
||||
.text = "Default key table. "
|
||||
"Key presses are first looked up in this table."
|
||||
},
|
||||
|
||||
{ .name = "lock-after-time",
|
||||
@ -396,13 +448,16 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.minimum = 0,
|
||||
.maximum = INT_MAX,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.unit = "seconds",
|
||||
.text = "Time after which a client is locked if not used."
|
||||
},
|
||||
|
||||
{ .name = "lock-command",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = "lock -np"
|
||||
.default_str = "lock -np",
|
||||
.text = "Shell command to run to lock a client."
|
||||
},
|
||||
|
||||
{ .name = "message-command-style",
|
||||
@ -410,7 +465,9 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = "bg=black,fg=yellow",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of the command prompt when in command mode, if "
|
||||
"'mode-keys' is set to 'vi'."
|
||||
},
|
||||
|
||||
{ .name = "message-style",
|
||||
@ -418,31 +475,39 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = "bg=yellow,fg=black",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of the command prompt."
|
||||
},
|
||||
|
||||
{ .name = "mouse",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Whether the mouse is recognised and mouse key bindings are "
|
||||
"executed. "
|
||||
"Applications inside panes can use the mouse even when 'off'."
|
||||
},
|
||||
|
||||
{ .name = "prefix",
|
||||
.type = OPTIONS_TABLE_KEY,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_num = '\002',
|
||||
.text = "The prefix key."
|
||||
},
|
||||
|
||||
{ .name = "prefix2",
|
||||
.type = OPTIONS_TABLE_KEY,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_num = KEYC_NONE,
|
||||
.text = "A second prefix key."
|
||||
},
|
||||
|
||||
{ .name = "renumber-windows",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Whether windows are automatically renumbered rather than "
|
||||
"leaving gaps."
|
||||
},
|
||||
|
||||
{ .name = "repeat-time",
|
||||
@ -450,45 +515,56 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.minimum = 0,
|
||||
.maximum = SHRT_MAX,
|
||||
.default_num = 500
|
||||
.default_num = 500,
|
||||
.unit = "milliseconds",
|
||||
.text = "Time to wait for a key binding to repeat, if it is bound "
|
||||
"with the '-r' flag."
|
||||
},
|
||||
|
||||
{ .name = "set-titles",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Whether to set the terminal title, if supported."
|
||||
},
|
||||
|
||||
{ .name = "set-titles-string",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = "#S:#I:#W - \"#T\" #{session_alerts}"
|
||||
.default_str = "#S:#I:#W - \"#T\" #{session_alerts}",
|
||||
.text = "Format of the terminal title to set."
|
||||
},
|
||||
|
||||
{ .name = "silence-action",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.choices = options_table_bell_action_list,
|
||||
.default_num = ALERT_OTHER
|
||||
.default_num = ALERT_OTHER,
|
||||
.text = "Action to take on a silence alert."
|
||||
},
|
||||
|
||||
{ .name = "status",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.choices = options_table_status_list,
|
||||
.default_num = 1
|
||||
.default_num = 1,
|
||||
.text = "Number of lines in the status line."
|
||||
},
|
||||
|
||||
{ .name = "status-bg",
|
||||
.type = OPTIONS_TABLE_COLOUR,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_num = 8,
|
||||
.text = "Background colour of the status line. This option is "
|
||||
"deprecated, use 'status-style' instead."
|
||||
},
|
||||
|
||||
{ .name = "status-fg",
|
||||
.type = OPTIONS_TABLE_COLOUR,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_num = 8,
|
||||
.text = "Foreground colour of the status line. This option is "
|
||||
"deprecated, use 'status-style' instead."
|
||||
},
|
||||
|
||||
{ .name = "status-format",
|
||||
@ -496,6 +572,11 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.flags = OPTIONS_TABLE_IS_ARRAY,
|
||||
.default_arr = options_table_status_format_default,
|
||||
.text = "Formats for the status lines. "
|
||||
"Each array member is the format for one status line. "
|
||||
"The default status line is made up of several components "
|
||||
"which may be configured individually with other option such "
|
||||
"as 'status-left'."
|
||||
},
|
||||
|
||||
{ .name = "status-interval",
|
||||
@ -503,27 +584,32 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.minimum = 0,
|
||||
.maximum = INT_MAX,
|
||||
.default_num = 15
|
||||
.default_num = 15,
|
||||
.unit = "seconds",
|
||||
.text = "Number of seconds between status line updates."
|
||||
},
|
||||
|
||||
{ .name = "status-justify",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.choices = options_table_status_justify_list,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Position of the window list in the status line."
|
||||
},
|
||||
|
||||
{ .name = "status-keys",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.choices = options_table_status_keys_list,
|
||||
.default_num = MODEKEY_EMACS
|
||||
.default_num = MODEKEY_EMACS,
|
||||
.text = "Key set to use at the command prompt."
|
||||
},
|
||||
|
||||
{ .name = "status-left",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = "[#S] "
|
||||
.default_str = "[#{session_name}] ",
|
||||
.text = "Contents of the left side of the status line."
|
||||
},
|
||||
|
||||
{ .name = "status-left-length",
|
||||
@ -531,7 +617,8 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.minimum = 0,
|
||||
.maximum = SHRT_MAX,
|
||||
.default_num = 10
|
||||
.default_num = 10,
|
||||
.text = "Maximum width of the left side of the status line."
|
||||
},
|
||||
|
||||
{ .name = "status-left-style",
|
||||
@ -539,22 +626,26 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = "default",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of the left side of the status line."
|
||||
},
|
||||
|
||||
{ .name = "status-position",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.choices = options_table_status_position_list,
|
||||
.default_num = 1
|
||||
.default_num = 1,
|
||||
.text = "Position of the status line."
|
||||
},
|
||||
|
||||
{ .name = "status-right",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = "#{?window_bigger,"
|
||||
"[#{window_offset_x}#,#{window_offset_y}] ,}"
|
||||
"\"#{=21:pane_title}\" %H:%M %d-%b-%y"
|
||||
"[#{window_offset_x}#,#{window_offset_y}] ,}"
|
||||
"\"#{=21:pane_title}\" %H:%M %d-%b-%y",
|
||||
.text = "Contents of the right side of the status line."
|
||||
|
||||
},
|
||||
|
||||
{ .name = "status-right-length",
|
||||
@ -562,7 +653,8 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.minimum = 0,
|
||||
.maximum = SHRT_MAX,
|
||||
.default_num = 40
|
||||
.default_num = 40,
|
||||
.text = "Maximum width of the right side of the status line."
|
||||
},
|
||||
|
||||
{ .name = "status-right-style",
|
||||
@ -570,7 +662,8 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = "default",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of the right side of the status line."
|
||||
},
|
||||
|
||||
{ .name = "status-style",
|
||||
@ -578,7 +671,8 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = "bg=green,fg=black",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of the status line."
|
||||
},
|
||||
|
||||
{ .name = "update-environment",
|
||||
@ -586,79 +680,100 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.flags = OPTIONS_TABLE_IS_ARRAY,
|
||||
.default_str = "DISPLAY KRB5CCNAME SSH_ASKPASS SSH_AUTH_SOCK "
|
||||
"SSH_AGENT_PID SSH_CONNECTION WINDOWID XAUTHORITY"
|
||||
"SSH_AGENT_PID SSH_CONNECTION WINDOWID XAUTHORITY",
|
||||
.text = "List of environment variables to update in the session "
|
||||
"environment when a client is attached."
|
||||
},
|
||||
|
||||
{ .name = "visual-activity",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.choices = options_table_visual_bell_list,
|
||||
.default_num = VISUAL_OFF
|
||||
.default_num = VISUAL_OFF,
|
||||
.text = "How activity alerts should be shown: a message ('on'), "
|
||||
"a message and a bell ('both') or nothing ('off')."
|
||||
},
|
||||
|
||||
{ .name = "visual-bell",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.choices = options_table_visual_bell_list,
|
||||
.default_num = VISUAL_OFF
|
||||
.default_num = VISUAL_OFF,
|
||||
.text = "How bell alerts should be shown: a message ('on'), "
|
||||
"a message and a bell ('both') or nothing ('off')."
|
||||
},
|
||||
|
||||
{ .name = "visual-silence",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.choices = options_table_visual_bell_list,
|
||||
.default_num = VISUAL_OFF
|
||||
.default_num = VISUAL_OFF,
|
||||
.text = "How silence alerts should be shown: a message ('on'), "
|
||||
"a message and a bell ('both') or nothing ('off')."
|
||||
},
|
||||
|
||||
{ .name = "word-separators",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_SESSION,
|
||||
.default_str = " "
|
||||
.default_str = " ",
|
||||
.text = "Characters considered to separate words."
|
||||
},
|
||||
|
||||
/* Window options. */
|
||||
{ .name = "aggressive-resize",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "When 'window-size' is 'smallest', whether the maximum size "
|
||||
"of a window is the smallest attached session where it is "
|
||||
"the current window ('on') or the smallest session it is "
|
||||
"linked to ('off')."
|
||||
},
|
||||
|
||||
{ .name = "allow-rename",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Whether applications are allowed to use the escape sequence "
|
||||
"to rename windows."
|
||||
},
|
||||
|
||||
{ .name = "alternate-screen",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
|
||||
.default_num = 1
|
||||
.default_num = 1,
|
||||
.text = "Whether applications are allowed to use the alternate "
|
||||
"screen."
|
||||
},
|
||||
|
||||
{ .name = "automatic-rename",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_num = 1
|
||||
.default_num = 1,
|
||||
.text = "Whether windows are automatically renamed."
|
||||
},
|
||||
|
||||
{ .name = "automatic-rename-format",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "#{?pane_in_mode,[tmux],#{pane_current_command}}"
|
||||
"#{?pane_dead,[dead],}"
|
||||
"#{?pane_dead,[dead],}",
|
||||
.text = "Format used to automatically rename windows."
|
||||
},
|
||||
|
||||
{ .name = "clock-mode-colour",
|
||||
.type = OPTIONS_TABLE_COLOUR,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_num = 4
|
||||
.default_num = 4,
|
||||
.text = "Colour of the clock in clock mode."
|
||||
},
|
||||
|
||||
{ .name = "clock-mode-style",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.choices = options_table_clock_mode_style_list,
|
||||
.default_num = 1
|
||||
.default_num = 1,
|
||||
.text = "Time format of the clock in clock mode."
|
||||
},
|
||||
|
||||
{ .name = "copy-mode-match-style",
|
||||
@ -666,7 +781,8 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "bg=cyan,fg=black",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of search matches in copy mode."
|
||||
},
|
||||
|
||||
{ .name = "copy-mode-current-match-style",
|
||||
@ -674,26 +790,32 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "bg=magenta,fg=black",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of the current search match in copy mode."
|
||||
},
|
||||
|
||||
{ .name = "main-pane-height",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "24"
|
||||
.default_str = "24",
|
||||
.text = "Height of the main pane in the 'main-horizontal' layout. "
|
||||
"This may be a percentage, for example '10%'."
|
||||
},
|
||||
|
||||
{ .name = "main-pane-width",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "80"
|
||||
.default_str = "80",
|
||||
.text = "Width of the main pane in the 'main-vertical' layout. "
|
||||
"This may be a percentage, for example '10%'."
|
||||
},
|
||||
|
||||
{ .name = "mode-keys",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.choices = options_table_mode_keys_list,
|
||||
.default_num = MODEKEY_EMACS
|
||||
.default_num = MODEKEY_EMACS,
|
||||
.text = "Key set used in copy mode."
|
||||
},
|
||||
|
||||
{ .name = "mode-style",
|
||||
@ -701,19 +823,22 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "bg=yellow,fg=black",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of indicators and highlighting in modes."
|
||||
},
|
||||
|
||||
{ .name = "monitor-activity",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Whether an alert is triggered by activity."
|
||||
},
|
||||
|
||||
{ .name = "monitor-bell",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_num = 1
|
||||
.default_num = 1,
|
||||
.text = "Whether an alert is triggered by a bell."
|
||||
},
|
||||
|
||||
{ .name = "monitor-silence",
|
||||
@ -721,19 +846,26 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.minimum = 0,
|
||||
.maximum = INT_MAX,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Time after which an alert is triggered by silence. "
|
||||
"Zero means no alert."
|
||||
|
||||
},
|
||||
|
||||
{ .name = "other-pane-height",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "0"
|
||||
.default_str = "0",
|
||||
.text = "Height of the other panes in the 'main-horizontal' layout. "
|
||||
"This may be a percentage, for example '10%'."
|
||||
},
|
||||
|
||||
{ .name = "other-pane-width",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "0"
|
||||
.default_str = "0",
|
||||
.text = "Height of the other panes in the 'main-vertical' layout. "
|
||||
"This may be a percentage, for example '10%'."
|
||||
},
|
||||
|
||||
{ .name = "pane-active-border-style",
|
||||
@ -741,7 +873,8 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "#{?pane_in_mode,fg=yellow,#{?synchronize-panes,fg=red,fg=green}}",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of the active pane border."
|
||||
},
|
||||
|
||||
{ .name = "pane-base-index",
|
||||
@ -749,21 +882,24 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.minimum = 0,
|
||||
.maximum = USHRT_MAX,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Index of the first pane in each window."
|
||||
},
|
||||
|
||||
{ .name = "pane-border-format",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "#{?pane_active,#[reverse],}#{pane_index}#[default] "
|
||||
"\"#{pane_title}\""
|
||||
"\"#{pane_title}\"",
|
||||
.text = "Format of text in the pane status lines."
|
||||
},
|
||||
|
||||
{ .name = "pane-border-status",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.choices = options_table_pane_status_list,
|
||||
.default_num = PANE_STATUS_OFF
|
||||
.default_num = PANE_STATUS_OFF,
|
||||
.text = "Position of the pane status lines."
|
||||
},
|
||||
|
||||
{ .name = "pane-border-style",
|
||||
@ -771,19 +907,23 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "default",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of the pane status lines."
|
||||
},
|
||||
|
||||
{ .name = "remain-on-exit",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Whether panes should remain ('on') or be automatically "
|
||||
"killed ('off') when the program inside exits."
|
||||
},
|
||||
|
||||
{ .name = "synchronize-panes",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_num = 0
|
||||
.default_num = 0,
|
||||
.text = "Whether typing should be sent to all panes simultaneously."
|
||||
},
|
||||
|
||||
{ .name = "window-active-style",
|
||||
@ -791,14 +931,20 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
|
||||
.default_str = "default",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Default style of the active pane."
|
||||
},
|
||||
|
||||
{ .name = "window-size",
|
||||
.type = OPTIONS_TABLE_CHOICE,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.choices = options_table_window_size_list,
|
||||
.default_num = WINDOW_SIZE_LATEST
|
||||
.default_num = WINDOW_SIZE_LATEST,
|
||||
.text = "How window size is calculated. "
|
||||
"'latest' uses the size of the most recently used client, "
|
||||
"'largest' the largest client, 'smallest' the smallest "
|
||||
"client and 'manual' a size set by the 'resize-window' "
|
||||
"command."
|
||||
},
|
||||
|
||||
{ .name = "window-style",
|
||||
@ -806,7 +952,8 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
|
||||
.default_str = "default",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Default style of panes that are not the active pane."
|
||||
},
|
||||
|
||||
{ .name = "window-status-activity-style",
|
||||
@ -814,7 +961,8 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "reverse",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of windows in the status line with an activity alert."
|
||||
},
|
||||
|
||||
{ .name = "window-status-bell-style",
|
||||
@ -822,13 +970,15 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "reverse",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of windows in the status line with a bell alert."
|
||||
},
|
||||
|
||||
{ .name = "window-status-current-format",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "#I:#W#{?window_flags,#{window_flags}, }"
|
||||
.default_str = "#I:#W#{?window_flags,#{window_flags}, }",
|
||||
.text = "Format of the current window in the status line."
|
||||
},
|
||||
|
||||
{ .name = "window-status-current-style",
|
||||
@ -836,13 +986,16 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "default",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of the current window in the status line."
|
||||
},
|
||||
|
||||
{ .name = "window-status-format",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "#I:#W#{?window_flags,#{window_flags}, }"
|
||||
.default_str = "#I:#W#{?window_flags,#{window_flags}, }",
|
||||
.text = "Format of windows in the status line, except the current "
|
||||
"window."
|
||||
},
|
||||
|
||||
{ .name = "window-status-last-style",
|
||||
@ -850,13 +1003,15 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "default",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of the last window in the status line."
|
||||
},
|
||||
|
||||
{ .name = "window-status-separator",
|
||||
.type = OPTIONS_TABLE_STRING,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = " "
|
||||
.default_str = " ",
|
||||
.text = "Separator between windows in the status line."
|
||||
},
|
||||
|
||||
{ .name = "window-status-style",
|
||||
@ -864,19 +1019,24 @@ const struct options_table_entry options_table[] = {
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_str = "default",
|
||||
.flags = OPTIONS_TABLE_IS_STYLE,
|
||||
.separator = ","
|
||||
.separator = ",",
|
||||
.text = "Style of windows in the status line, except the current and "
|
||||
"last windows."
|
||||
},
|
||||
|
||||
{ .name = "wrap-search",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_num = 1
|
||||
.default_num = 1,
|
||||
.text = "Whether searching in copy mode should wrap at the top or "
|
||||
"bottom."
|
||||
},
|
||||
|
||||
{ .name = "xterm-keys",
|
||||
.type = OPTIONS_TABLE_FLAG,
|
||||
.scope = OPTIONS_TABLE_WINDOW,
|
||||
.default_num = 1
|
||||
.default_num = 1,
|
||||
.text = "Whether xterm-style function key sequences should be sent."
|
||||
},
|
||||
|
||||
/* Hook options. */
|
||||
|
Reference in New Issue
Block a user