options-table.c

   1 /* $OpenBSD$ */
   2
   3 /*
   4  * Copyright (c) 2011 Nicholas Marriott <nicholas.marriott@gmail.com>
   5  *
   6  * Permission to use, copy, modify, and distribute this software for any
   7  * purpose with or without fee is hereby granted, provided that the above
   8  * copyright notice and this permission notice appear in all copies.
   9  *
  10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  11  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  12  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  13  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  14  * WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
  15  * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
  16  * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  17  */
  18
  19 #include <sys/types.h>
  20
  21 #include <string.h>
  22
  23 #include "tmux.h"
  24
  25 /*
  26  * This file has a tables with all the server, session and window
  27  * options. These tables are the master copy of the options with their real
  28  * (user-visible) types, range limits and default values. At start these are
  29  * copied into the runtime global options trees (which only has number and
  30  * string types). These tables are then used to look up the real type when the
  31  * user sets an option or its value needs to be shown.
  32  */
  33
  34 /* Choice option type lists. */
  35 static const char *options_table_mode_keys_list[] = {
  36         "emacs", "vi", NULL
  37 };
  38 static const char *options_table_clock_mode_style_list[] = {
  39         "12", "24", NULL
  40 };
  41 static const char *options_table_status_list[] = {
  42         "off", "on", "2", "3", "4", "5", NULL
  43 };
  44 static const char *options_table_message_line_list[] = {
  45         "0", "1", "2", "3", "4", NULL
  46 };
  47 static const char *options_table_status_keys_list[] = {
  48         "emacs", "vi", NULL
  49 };
  50 static const char *options_table_status_justify_list[] = {
  51         "left", "centre", "right", "absolute-centre", NULL
  52 };
  53 static const char *options_table_status_position_list[] = {
  54         "top", "bottom", NULL
  55 };
  56 static const char *options_table_bell_action_list[] = {
  57         "none", "any", "current", "other", NULL
  58 };
  59 static const char *options_table_visual_bell_list[] = {
  60         "off", "on", "both", NULL
  61 };
  62 static const char *options_table_cursor_style_list[] = {
  63         "default", "blinking-block", "block", "blinking-underline", "underline",
  64         "blinking-bar", "bar", NULL
  65 };
  66 static const char *options_table_pane_scrollbars_list[] = {
  67         "off", "modal", "on", NULL
  68 };
  69 static const char *options_table_pane_scrollbars_position_list[] = {
  70         "right", "left", NULL
  71 };
  72 static const char *options_table_pane_status_list[] = {
  73         "off", "top", "bottom", NULL
  74 };
  75 static const char *options_table_pane_border_indicators_list[] = {
  76         "off", "colour", "arrows", "both", NULL
  77 };
  78 static const char *options_table_pane_border_lines_list[] = {
  79         "single", "double", "heavy", "simple", "number", NULL
  80 };
  81 static const char *options_table_popup_border_lines_list[] = {
  82         "single", "double", "heavy", "simple", "rounded", "padded", "none", NULL
  83 };
  84 static const char *options_table_set_clipboard_list[] = {
  85         "off", "external", "on", NULL
  86 };
  87 static const char *options_table_window_size_list[] = {
  88         "largest", "smallest", "manual", "latest", NULL
  89 };
  90 static const char *options_table_remain_on_exit_list[] = {
  91         "off", "on", "failed", NULL
  92 };
  93 static const char *options_table_destroy_unattached_list[] = {
  94         "off", "on", "keep-last", "keep-group", NULL
  95 };
  96 static const char *options_table_detach_on_destroy_list[] = {
  97         "off", "on", "no-detached", "previous", "next", NULL
  98 };
  99 static const char *options_table_extended_keys_list[] = {
 100         "off", "on", "always", NULL
 101 };
 102 static const char *options_table_extended_keys_format_list[] = {
 103         "csi-u", "xterm", NULL
 104 };
 105 static const char *options_table_allow_passthrough_list[] = {
 106         "off", "on", "all", NULL
 107 };
 108
 109 /* Status line format. */
 110 #define OPTIONS_TABLE_STATUS_FORMAT1 \
 111         "#[align=left range=left #{E:status-left-style}]" \
 112         "#[push-default]" \
 113         "#{T;=/#{status-left-length}:status-left}" \
 114         "#[pop-default]" \
 115         "#[norange default]" \
 116         "#[list=on align=#{status-justify}]" \
 117         "#[list=left-marker]<#[list=right-marker]>#[list=on]" \
 118         "#{W:" \
 119                 "#[range=window|#{window_index} " \
 120                         "#{E:window-status-style}" \
 121                         "#{?#{&&:#{window_last_flag}," \
 122                                 "#{!=:#{E:window-status-last-style},default}}, " \
 123                                 "#{E:window-status-last-style}," \
 124                         "}" \
 125                         "#{?#{&&:#{window_bell_flag}," \
 126                                 "#{!=:#{E:window-status-bell-style},default}}, " \
 127                                 "#{E:window-status-bell-style}," \
 128                                 "#{?#{&&:#{||:#{window_activity_flag}," \
 129                                              "#{window_silence_flag}}," \
 130                                         "#{!=:" \
 131                                         "#{E:window-status-activity-style}," \
 132                                         "default}}, " \
 133                                         "#{E:window-status-activity-style}," \
 134                                 "}" \
 135                         "}" \
 136                 "]" \
 137                 "#[push-default]" \
 138                 "#{T:window-status-format}" \
 139                 "#[pop-default]" \
 140                 "#[norange default]" \
 141                 "#{?window_end_flag,,#{window-status-separator}}" \
 142         "," \
 143                 "#[range=window|#{window_index} list=focus " \
 144                         "#{?#{!=:#{E:window-status-current-style},default}," \
 145                                 "#{E:window-status-current-style}," \
 146                                 "#{E:window-status-style}" \
 147                         "}" \
 148                         "#{?#{&&:#{window_last_flag}," \
 149                                 "#{!=:#{E:window-status-last-style},default}}, " \
 150                                 "#{E:window-status-last-style}," \
 151                         "}" \
 152                         "#{?#{&&:#{window_bell_flag}," \
 153                                 "#{!=:#{E:window-status-bell-style},default}}, " \
 154                                 "#{E:window-status-bell-style}," \
 155                                 "#{?#{&&:#{||:#{window_activity_flag}," \
 156                                              "#{window_silence_flag}}," \
 157                                         "#{!=:" \
 158                                         "#{E:window-status-activity-style}," \
 159                                         "default}}, " \
 160                                         "#{E:window-status-activity-style}," \
 161                                 "}" \
 162                         "}" \
 163                 "]" \
 164                 "#[push-default]" \
 165                 "#{T:window-status-current-format}" \
 166                 "#[pop-default]" \
 167                 "#[norange list=on default]" \
 168                 "#{?window_end_flag,,#{window-status-separator}}" \
 169         "}" \
 170         "#[nolist align=right range=right #{E:status-right-style}]" \
 171         "#[push-default]" \
 172         "#{T;=/#{status-right-length}:status-right}" \
 173         "#[pop-default]" \
 174         "#[norange default]"
 175 #define OPTIONS_TABLE_STATUS_FORMAT2 \
 176         "#[align=centre]#{P:#{?pane_active,#[reverse],}" \
 177         "#{pane_index}[#{pane_width}x#{pane_height}]#[default] }"
 178 static const char *options_table_status_format_default[] = {
 179         OPTIONS_TABLE_STATUS_FORMAT1, OPTIONS_TABLE_STATUS_FORMAT2, NULL
 180 };
 181
 182 /* Helpers for hook options. */
 183 #define OPTIONS_TABLE_HOOK(hook_name, default_value) \
 184         { .name = hook_name, \
 185           .type = OPTIONS_TABLE_COMMAND, \
 186           .scope = OPTIONS_TABLE_SESSION, \
 187           .flags = OPTIONS_TABLE_IS_ARRAY|OPTIONS_TABLE_IS_HOOK, \
 188           .default_str = default_value, \
 189           .separator = "" \
 190         }
 191
 192 #define OPTIONS_TABLE_PANE_HOOK(hook_name, default_value) \
 193         { .name = hook_name, \
 194           .type = OPTIONS_TABLE_COMMAND, \
 195           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE, \
 196           .flags = OPTIONS_TABLE_IS_ARRAY|OPTIONS_TABLE_IS_HOOK, \
 197           .default_str = default_value, \
 198           .separator = "" \
 199         }
 200
 201 #define OPTIONS_TABLE_WINDOW_HOOK(hook_name, default_value) \
 202         { .name = hook_name, \
 203           .type = OPTIONS_TABLE_COMMAND, \
 204           .scope = OPTIONS_TABLE_WINDOW, \
 205           .flags = OPTIONS_TABLE_IS_ARRAY|OPTIONS_TABLE_IS_HOOK, \
 206           .default_str = default_value, \
 207           .separator = "" \
 208         }
 209
 210 /* Map of name conversions. */
 211 const struct options_name_map options_other_names[] = {
 212         { "display-panes-color", "display-panes-colour" },
 213         { "display-panes-active-color", "display-panes-active-colour" },
 214         { "clock-mode-color", "clock-mode-colour" },
 215         { "cursor-color", "cursor-colour" },
 216         { "prompt-cursor-color", "prompt-cursor-colour" },
 217         { "pane-colors", "pane-colours" },
 218         { NULL, NULL }
 219 };
 220
 221 /* Top-level options. */
 222 const struct options_table_entry options_table[] = {
 223         /* Server options. */
 224         { .name = "backspace",
 225           .type = OPTIONS_TABLE_KEY,
 226           .scope = OPTIONS_TABLE_SERVER,
 227           .default_num = '\177',
 228           .text = "The key to send for backspace."
 229         },
 230
 231         { .name = "buffer-limit",
 232           .type = OPTIONS_TABLE_NUMBER,
 233           .scope = OPTIONS_TABLE_SERVER,
 234           .minimum = 1,
 235           .maximum = INT_MAX,
 236           .default_num = 50,
 237           .text = "The maximum number of automatic buffers. "
 238                   "When this is reached, the oldest buffer is deleted."
 239         },
 240
 241         { .name = "command-alias",
 242           .type = OPTIONS_TABLE_STRING,
 243           .scope = OPTIONS_TABLE_SERVER,
 244           .flags = OPTIONS_TABLE_IS_ARRAY,
 245           .default_str = "split-pane=split-window,"
 246                          "splitp=split-window,"
 247                          "server-info=show-messages -JT,"
 248                          "info=show-messages -JT,"
 249                          "choose-window=choose-tree -w,"
 250                          "choose-session=choose-tree -s",
 251           .separator = ",",
 252           .text = "Array of command aliases. "
 253                   "Each entry is an alias and a command separated by '='."
 254         },
 255
 256         { .name = "copy-command",
 257           .type = OPTIONS_TABLE_STRING,
 258           .scope = OPTIONS_TABLE_SERVER,
 259           .default_str = "",
 260           .text = "Shell command run when text is copied. "
 261                   "If empty, no command is run."
 262         },
 263
 264         { .name = "cursor-colour",
 265           .type = OPTIONS_TABLE_COLOUR,
 266           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
 267           .default_num = -1,
 268           .text = "Colour of the cursor."
 269         },
 270
 271         { .name = "cursor-style",
 272           .type = OPTIONS_TABLE_CHOICE,
 273           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
 274           .choices = options_table_cursor_style_list,
 275           .default_num = 0,
 276           .text = "Style of the cursor."
 277         },
 278
 279         { .name = "default-terminal",
 280           .type = OPTIONS_TABLE_STRING,
 281           .scope = OPTIONS_TABLE_SERVER,
 282           .default_str = TMUX_TERM,
 283           .text = "Default for the 'TERM' environment variable."
 284         },
 285
 286         { .name = "editor",
 287           .type = OPTIONS_TABLE_STRING,
 288           .scope = OPTIONS_TABLE_SERVER,
 289           .default_str = _PATH_VI,
 290           .text = "Editor run to edit files."
 291         },
 292
 293         { .name = "escape-time",
 294           .type = OPTIONS_TABLE_NUMBER,
 295           .scope = OPTIONS_TABLE_SERVER,
 296           .minimum = 0,
 297           .maximum = INT_MAX,
 298           .default_num = 10,
 299           .unit = "milliseconds",
 300           .text = "Time to wait before assuming a key is Escape."
 301         },
 302
 303         { .name = "exit-empty",
 304           .type = OPTIONS_TABLE_FLAG,
 305           .scope = OPTIONS_TABLE_SERVER,
 306           .default_num = 1,
 307           .text = "Whether the server should exit if there are no sessions."
 308         },
 309
 310         { .name = "exit-unattached",
 311           .type = OPTIONS_TABLE_FLAG,
 312           .scope = OPTIONS_TABLE_SERVER,
 313           .default_num = 0,
 314           .text = "Whether the server should exit if there are no attached "
 315                   "clients."
 316         },
 317
 318         { .name = "extended-keys",
 319           .type = OPTIONS_TABLE_CHOICE,
 320           .scope = OPTIONS_TABLE_SERVER,
 321           .choices = options_table_extended_keys_list,
 322           .default_num = 0,
 323           .text = "Whether to request extended key sequences from terminals "
 324                   "that support it."
 325         },
 326
 327         { .name = "extended-keys-format",
 328           .type = OPTIONS_TABLE_CHOICE,
 329           .scope = OPTIONS_TABLE_SERVER,
 330           .choices = options_table_extended_keys_format_list,
 331           .default_num = 1,
 332           .text = "The format of emitted extended key sequences."
 333         },
 334
 335         { .name = "focus-events",
 336           .type = OPTIONS_TABLE_FLAG,
 337           .scope = OPTIONS_TABLE_SERVER,
 338           .default_num = 0,
 339           .text = "Whether to send focus events to applications."
 340         },
 341
 342         { .name = "history-file",
 343           .type = OPTIONS_TABLE_STRING,
 344           .scope = OPTIONS_TABLE_SERVER,
 345           .default_str = "",
 346           .text = "Location of the command prompt history file. "
 347                   "Empty does not write a history file."
 348         },
 349
 350         { .name = "input-buffer-size",
 351           .type = OPTIONS_TABLE_NUMBER,
 352           .scope = OPTIONS_TABLE_SERVER,
 353           .minimum = INPUT_BUF_DEFAULT_SIZE,
 354           .maximum = UINT_MAX,
 355           .default_num = INPUT_BUF_DEFAULT_SIZE,
 356           .text = "Number of byte accpted in a single input before dropping."
 357         },
 358
 359         { .name = "menu-style",
 360           .type = OPTIONS_TABLE_STRING,
 361           .scope = OPTIONS_TABLE_WINDOW,
 362           .flags = OPTIONS_TABLE_IS_STYLE,
 363           .default_str = "default",
 364           .separator = ",",
 365           .text = "Default style of menu."
 366         },
 367
 368         { .name = "menu-selected-style",
 369           .type = OPTIONS_TABLE_STRING,
 370           .scope = OPTIONS_TABLE_WINDOW,
 371           .flags = OPTIONS_TABLE_IS_STYLE,
 372           .default_str = "bg=yellow,fg=black",
 373           .separator = ",",
 374           .text = "Default style of selected menu item."
 375         },
 376
 377         { .name = "menu-border-style",
 378           .type = OPTIONS_TABLE_STRING,
 379           .scope = OPTIONS_TABLE_WINDOW,
 380           .default_str = "default",
 381           .flags = OPTIONS_TABLE_IS_STYLE,
 382           .separator = ",",
 383           .text = "Default style of menu borders."
 384         },
 385
 386         { .name = "menu-border-lines",
 387           .type = OPTIONS_TABLE_CHOICE,
 388           .scope = OPTIONS_TABLE_WINDOW,
 389           .choices = options_table_popup_border_lines_list,
 390           .default_num = BOX_LINES_SINGLE,
 391           .text = "Type of characters used to draw menu border lines. Some of "
 392                   "these are only supported on terminals with UTF-8 support."
 393         },
 394
 395         { .name = "message-limit",
 396           .type = OPTIONS_TABLE_NUMBER,
 397           .scope = OPTIONS_TABLE_SERVER,
 398           .minimum = 0,
 399           .maximum = INT_MAX,
 400           .default_num = 1000,
 401           .text = "Maximum number of server messages to keep."
 402         },
 403
 404         { .name = "prefix-timeout",
 405           .type = OPTIONS_TABLE_NUMBER,
 406           .scope = OPTIONS_TABLE_SERVER,
 407           .minimum = 0,
 408           .maximum = INT_MAX,
 409           .default_num = 0,
 410           .unit = "milliseconds",
 411           .text = "The timeout for the prefix key if no subsequent key is "
 412                   "pressed. Zero means disabled."
 413         },
 414
 415         { .name = "prompt-history-limit",
 416           .type = OPTIONS_TABLE_NUMBER,
 417           .scope = OPTIONS_TABLE_SERVER,
 418           .minimum = 0,
 419           .maximum = INT_MAX,
 420           .default_num = 100,
 421           .text = "Maximum number of commands to keep in history."
 422         },
 423
 424         { .name = "set-clipboard",
 425           .type = OPTIONS_TABLE_CHOICE,
 426           .scope = OPTIONS_TABLE_SERVER,
 427           .choices = options_table_set_clipboard_list,
 428           .default_num = 1,
 429           .text = "Whether to attempt to set the system clipboard ('on' or "
 430                   "'external') and whether to allow applications to create "
 431                   "paste buffers with an escape sequence ('on' only)."
 432         },
 433
 434         { .name = "terminal-overrides",
 435           .type = OPTIONS_TABLE_STRING,
 436           .scope = OPTIONS_TABLE_SERVER,
 437           .flags = OPTIONS_TABLE_IS_ARRAY,
 438           .default_str = "linux*:AX@",
 439           .separator = ",",
 440           .text = "List of terminal capabilities overrides."
 441         },
 442
 443         { .name = "terminal-features",
 444           .type = OPTIONS_TABLE_STRING,
 445           .scope = OPTIONS_TABLE_SERVER,
 446           .flags = OPTIONS_TABLE_IS_ARRAY,
 447           .default_str = "xterm*:clipboard:ccolour:cstyle:focus:title,"
 448                          "screen*:title,"
 449                          "rxvt*:ignorefkeys",
 450           .separator = ",",
 451           .text = "List of terminal features, used if they cannot be "
 452                   "automatically detected."
 453         },
 454
 455         { .name = "user-keys",
 456           .type = OPTIONS_TABLE_STRING,
 457           .scope = OPTIONS_TABLE_SERVER,
 458           .flags = OPTIONS_TABLE_IS_ARRAY,
 459           .default_str = "",
 460           .separator = ",",
 461           .text = "User key assignments. "
 462                   "Each sequence in the list is translated into a key: "
 463                   "'User0', 'User1' and so on."
 464         },
 465
 466         /* Session options. */
 467         { .name = "activity-action",
 468           .type = OPTIONS_TABLE_CHOICE,
 469           .scope = OPTIONS_TABLE_SESSION,
 470           .choices = options_table_bell_action_list,
 471           .default_num = ALERT_OTHER,
 472           .text = "Action to take on an activity alert."
 473         },
 474
 475         { .name = "assume-paste-time",
 476           .type = OPTIONS_TABLE_NUMBER,
 477           .scope = OPTIONS_TABLE_SESSION,
 478           .minimum = 0,
 479           .maximum = INT_MAX,
 480           .default_num = 1,
 481           .unit = "milliseconds",
 482           .text = "Maximum time between input to assume it is pasting rather "
 483                   "than typing."
 484         },
 485
 486         { .name = "base-index",
 487           .type = OPTIONS_TABLE_NUMBER,
 488           .scope = OPTIONS_TABLE_SESSION,
 489           .minimum = 0,
 490           .maximum = INT_MAX,
 491           .default_num = 0,
 492           .text = "Default index of the first window in each session."
 493         },
 494
 495         { .name = "bell-action",
 496           .type = OPTIONS_TABLE_CHOICE,
 497           .scope = OPTIONS_TABLE_SESSION,
 498           .choices = options_table_bell_action_list,
 499           .default_num = ALERT_ANY,
 500           .text = "Action to take on a bell alert."
 501         },
 502
 503         { .name = "default-command",
 504           .type = OPTIONS_TABLE_STRING,
 505           .scope = OPTIONS_TABLE_SESSION,
 506           .default_str = "",
 507           .text = "Default command to run in new panes. If empty, a shell is "
 508                   "started."
 509         },
 510
 511         { .name = "default-shell",
 512           .type = OPTIONS_TABLE_STRING,
 513           .scope = OPTIONS_TABLE_SESSION,
 514           .default_str = _PATH_BSHELL,
 515           .text = "Location of default shell."
 516         },
 517
 518         { .name = "default-size",
 519           .type = OPTIONS_TABLE_STRING,
 520           .scope = OPTIONS_TABLE_SESSION,
 521           .pattern = "[0-9]*x[0-9]*",
 522           .default_str = "80x24",
 523           .text = "Initial size of new sessions."
 524         },
 525
 526         { .name = "destroy-unattached",
 527           .type = OPTIONS_TABLE_CHOICE,
 528           .scope = OPTIONS_TABLE_SESSION,
 529           .choices = options_table_destroy_unattached_list,
 530           .default_num = 0,
 531           .text = "Whether to destroy sessions when they have no attached "
 532                   "clients, or keep the last session whether in the group."
 533         },
 534
 535         { .name = "detach-on-destroy",
 536           .type = OPTIONS_TABLE_CHOICE,
 537           .scope = OPTIONS_TABLE_SESSION,
 538           .choices = options_table_detach_on_destroy_list,
 539           .default_num = 1,
 540           .text = "Whether to detach when a session is destroyed, or switch "
 541                   "the client to another session if any exist."
 542         },
 543
 544         { .name = "display-panes-active-colour",
 545           .type = OPTIONS_TABLE_COLOUR,
 546           .scope = OPTIONS_TABLE_SESSION,
 547           .default_num = 1,
 548           .text = "Colour of the active pane for 'display-panes'."
 549         },
 550
 551         { .name = "display-panes-colour",
 552           .type = OPTIONS_TABLE_COLOUR,
 553           .scope = OPTIONS_TABLE_SESSION,
 554           .default_num = 4,
 555           .text = "Colour of not active panes for 'display-panes'."
 556         },
 557
 558         { .name = "display-panes-time",
 559           .type = OPTIONS_TABLE_NUMBER,
 560           .scope = OPTIONS_TABLE_SESSION,
 561           .minimum = 1,
 562           .maximum = INT_MAX,
 563           .default_num = 1000,
 564           .unit = "milliseconds",
 565           .text = "Time for which 'display-panes' should show pane numbers."
 566         },
 567
 568         { .name = "display-time",
 569           .type = OPTIONS_TABLE_NUMBER,
 570           .scope = OPTIONS_TABLE_SESSION,
 571           .minimum = 0,
 572           .maximum = INT_MAX,
 573           .default_num = 750,
 574           .unit = "milliseconds",
 575           .text = "Time for which status line messages should appear."
 576         },
 577
 578         { .name = "history-limit",
 579           .type = OPTIONS_TABLE_NUMBER,
 580           .scope = OPTIONS_TABLE_SESSION,
 581           .minimum = 0,
 582           .maximum = INT_MAX,
 583           .default_num = 2000,
 584           .unit = "lines",
 585           .text = "Maximum number of lines to keep in the history for each "
 586                   "pane. "
 587                   "If changed, the new value applies only to new panes."
 588         },
 589
 590         { .name = "initial-repeat-time",
 591           .type = OPTIONS_TABLE_NUMBER,
 592           .scope = OPTIONS_TABLE_SESSION,
 593           .minimum = 0,
 594           .maximum = 2000000,
 595           .default_num = 0,
 596           .unit = "milliseconds",
 597           .text = "Time to wait for a key binding to repeat the first time the "
 598                   "key is pressed, if it is bound with the '-r' flag. "
 599                   "Subsequent presses use the 'repeat-time' option."
 600         },
 601
 602         { .name = "key-table",
 603           .type = OPTIONS_TABLE_STRING,
 604           .scope = OPTIONS_TABLE_SESSION,
 605           .default_str = "root",
 606           .text = "Default key table. "
 607                   "Key presses are first looked up in this table."
 608         },
 609
 610         { .name = "lock-after-time",
 611           .type = OPTIONS_TABLE_NUMBER,
 612           .scope = OPTIONS_TABLE_SESSION,
 613           .minimum = 0,
 614           .maximum = INT_MAX,
 615           .default_num = 0,
 616           .unit = "seconds",
 617           .text = "Time after which a client is locked if not used."
 618         },
 619
 620         { .name = "lock-command",
 621           .type = OPTIONS_TABLE_STRING,
 622           .scope = OPTIONS_TABLE_SESSION,
 623           .default_str = TMUX_LOCK_CMD,
 624           .text = "Shell command to run to lock a client."
 625         },
 626
 627         { .name = "message-command-style",
 628           .type = OPTIONS_TABLE_STRING,
 629           .scope = OPTIONS_TABLE_SESSION,
 630           .default_str = "bg=black,fg=yellow",
 631           .flags = OPTIONS_TABLE_IS_STYLE,
 632           .separator = ",",
 633           .text = "Style of the command prompt when in command mode, if "
 634                   "'mode-keys' is set to 'vi'."
 635         },
 636
 637         { .name = "message-line",
 638           .type = OPTIONS_TABLE_CHOICE,
 639           .scope = OPTIONS_TABLE_SESSION,
 640           .choices = options_table_message_line_list,
 641           .default_num = 0,
 642           .text = "Position (line) of messages and the command prompt."
 643         },
 644
 645         { .name = "message-style",
 646           .type = OPTIONS_TABLE_STRING,
 647           .scope = OPTIONS_TABLE_SESSION,
 648           .default_str = "bg=yellow,fg=black",
 649           .flags = OPTIONS_TABLE_IS_STYLE,
 650           .separator = ",",
 651           .text = "Style of messages and the command prompt."
 652         },
 653
 654         { .name = "mouse",
 655           .type = OPTIONS_TABLE_FLAG,
 656           .scope = OPTIONS_TABLE_SESSION,
 657           .default_num = 0,
 658           .text = "Whether the mouse is recognised and mouse key bindings are "
 659                   "executed. "
 660                   "Applications inside panes can use the mouse even when 'off'."
 661         },
 662
 663         { .name = "prefix",
 664           .type = OPTIONS_TABLE_KEY,
 665           .scope = OPTIONS_TABLE_SESSION,
 666           .default_num = 'b'|KEYC_CTRL,
 667           .text = "The prefix key."
 668         },
 669
 670         { .name = "prefix2",
 671           .type = OPTIONS_TABLE_KEY,
 672           .scope = OPTIONS_TABLE_SESSION,
 673           .default_num = KEYC_NONE,
 674           .text = "A second prefix key."
 675         },
 676
 677         { .name = "renumber-windows",
 678           .type = OPTIONS_TABLE_FLAG,
 679           .scope = OPTIONS_TABLE_SESSION,
 680           .default_num = 0,
 681           .text = "Whether windows are automatically renumbered rather than "
 682                   "leaving gaps."
 683         },
 684
 685         { .name = "repeat-time",
 686           .type = OPTIONS_TABLE_NUMBER,
 687           .scope = OPTIONS_TABLE_SESSION,
 688           .minimum = 0,
 689           .maximum = 2000000,
 690           .default_num = 500,
 691           .unit = "milliseconds",
 692           .text = "Time to wait for a key binding to repeat, if it is bound "
 693                   "with the '-r' flag."
 694         },
 695
 696         { .name = "set-titles",
 697           .type = OPTIONS_TABLE_FLAG,
 698           .scope = OPTIONS_TABLE_SESSION,
 699           .default_num = 0,
 700           .text = "Whether to set the terminal title, if supported."
 701         },
 702
 703         { .name = "set-titles-string",
 704           .type = OPTIONS_TABLE_STRING,
 705           .scope = OPTIONS_TABLE_SESSION,
 706           .default_str = "#S:#I:#W - \"#T\" #{session_alerts}",
 707           .text = "Format of the terminal title to set."
 708         },
 709
 710         { .name = "silence-action",
 711           .type = OPTIONS_TABLE_CHOICE,
 712           .scope = OPTIONS_TABLE_SESSION,
 713           .choices = options_table_bell_action_list,
 714           .default_num = ALERT_OTHER,
 715           .text = "Action to take on a silence alert."
 716         },
 717
 718         { .name = "status",
 719           .type = OPTIONS_TABLE_CHOICE,
 720           .scope = OPTIONS_TABLE_SESSION,
 721           .choices = options_table_status_list,
 722           .default_num = 1,
 723           .text = "Number of lines in the status line."
 724         },
 725
 726         { .name = "status-bg",
 727           .type = OPTIONS_TABLE_COLOUR,
 728           .scope = OPTIONS_TABLE_SESSION,
 729           .default_num = 8,
 730           .text = "Background colour of the status line. This option is "
 731                   "deprecated, use 'status-style' instead."
 732         },
 733
 734         { .name = "status-fg",
 735           .type = OPTIONS_TABLE_COLOUR,
 736           .scope = OPTIONS_TABLE_SESSION,
 737           .default_num = 8,
 738           .text = "Foreground colour of the status line. This option is "
 739                   "deprecated, use 'status-style' instead."
 740         },
 741
 742         { .name = "status-format",
 743           .type = OPTIONS_TABLE_STRING,
 744           .scope = OPTIONS_TABLE_SESSION,
 745           .flags = OPTIONS_TABLE_IS_ARRAY,
 746           .default_arr = options_table_status_format_default,
 747           .text = "Formats for the status lines. "
 748                   "Each array member is the format for one status line. "
 749                   "The default status line is made up of several components "
 750                   "which may be configured individually with other options such "
 751                   "as 'status-left'."
 752         },
 753
 754         { .name = "status-interval",
 755           .type = OPTIONS_TABLE_NUMBER,
 756           .scope = OPTIONS_TABLE_SESSION,
 757           .minimum = 0,
 758           .maximum = INT_MAX,
 759           .default_num = 15,
 760           .unit = "seconds",
 761           .text = "Number of seconds between status line updates."
 762         },
 763
 764         { .name = "status-justify",
 765           .type = OPTIONS_TABLE_CHOICE,
 766           .scope = OPTIONS_TABLE_SESSION,
 767           .choices = options_table_status_justify_list,
 768           .default_num = 0,
 769           .text = "Position of the window list in the status line."
 770         },
 771
 772         { .name = "status-keys",
 773           .type = OPTIONS_TABLE_CHOICE,
 774           .scope = OPTIONS_TABLE_SESSION,
 775           .choices = options_table_status_keys_list,
 776           .default_num = MODEKEY_EMACS,
 777           .text = "Key set to use at the command prompt."
 778         },
 779
 780         { .name = "status-left",
 781           .type = OPTIONS_TABLE_STRING,
 782           .scope = OPTIONS_TABLE_SESSION,
 783           .default_str = "[#{session_name}] ",
 784           .text = "Contents of the left side of the status line."
 785         },
 786
 787         { .name = "status-left-length",
 788           .type = OPTIONS_TABLE_NUMBER,
 789           .scope = OPTIONS_TABLE_SESSION,
 790           .minimum = 0,
 791           .maximum = SHRT_MAX,
 792           .default_num = 10,
 793           .text = "Maximum width of the left side of the status line."
 794         },
 795
 796         { .name = "status-left-style",
 797           .type = OPTIONS_TABLE_STRING,
 798           .scope = OPTIONS_TABLE_SESSION,
 799           .default_str = "default",
 800           .flags = OPTIONS_TABLE_IS_STYLE,
 801           .separator = ",",
 802           .text = "Style of the left side of the status line."
 803         },
 804
 805         { .name = "status-position",
 806           .type = OPTIONS_TABLE_CHOICE,
 807           .scope = OPTIONS_TABLE_SESSION,
 808           .choices = options_table_status_position_list,
 809           .default_num = 1,
 810           .text = "Position of the status line."
 811         },
 812
 813         { .name = "status-right",
 814           .type = OPTIONS_TABLE_STRING,
 815           .scope = OPTIONS_TABLE_SESSION,
 816           .default_str = "#{?window_bigger,"
 817                          "[#{window_offset_x}#,#{window_offset_y}] ,}"
 818                          "\"#{=21:pane_title}\" %H:%M %d-%b-%y",
 819           .text = "Contents of the right side of the status line."
 820
 821         },
 822
 823         { .name = "status-right-length",
 824           .type = OPTIONS_TABLE_NUMBER,
 825           .scope = OPTIONS_TABLE_SESSION,
 826           .minimum = 0,
 827           .maximum = SHRT_MAX,
 828           .default_num = 40,
 829           .text = "Maximum width of the right side of the status line."
 830         },
 831
 832         { .name = "status-right-style",
 833           .type = OPTIONS_TABLE_STRING,
 834           .scope = OPTIONS_TABLE_SESSION,
 835           .default_str = "default",
 836           .flags = OPTIONS_TABLE_IS_STYLE,
 837           .separator = ",",
 838           .text = "Style of the right side of the status line."
 839         },
 840
 841         { .name = "status-style",
 842           .type = OPTIONS_TABLE_STRING,
 843           .scope = OPTIONS_TABLE_SESSION,
 844           .default_str = "bg=green,fg=black",
 845           .flags = OPTIONS_TABLE_IS_STYLE,
 846           .separator = ",",
 847           .text = "Style of the status line."
 848         },
 849
 850         { .name = "prompt-cursor-colour",
 851           .type = OPTIONS_TABLE_COLOUR,
 852           .scope = OPTIONS_TABLE_SESSION,
 853           .default_num = 6,
 854           .text = "Colour of the cursor when in the command prompt."
 855         },
 856
 857         { .name = "prompt-cursor-style",
 858           .type = OPTIONS_TABLE_CHOICE,
 859           .scope = OPTIONS_TABLE_SESSION,
 860           .choices = options_table_cursor_style_list,
 861           .default_num = 0,
 862           .text = "Style of the cursor when in the command prompt."
 863         },
 864
 865         { .name = "update-environment",
 866           .type = OPTIONS_TABLE_STRING,
 867           .scope = OPTIONS_TABLE_SESSION,
 868           .flags = OPTIONS_TABLE_IS_ARRAY,
 869           .default_str = "DISPLAY KRB5CCNAME MSYSTEM SSH_ASKPASS SSH_AUTH_SOCK "
 870                          "SSH_AGENT_PID SSH_CONNECTION WINDOWID XAUTHORITY",
 871           .text = "List of environment variables to update in the session "
 872                   "environment when a client is attached."
 873         },
 874
 875         { .name = "visual-activity",
 876           .type = OPTIONS_TABLE_CHOICE,
 877           .scope = OPTIONS_TABLE_SESSION,
 878           .choices = options_table_visual_bell_list,
 879           .default_num = VISUAL_OFF,
 880           .text = "How activity alerts should be shown: a message ('on'), "
 881                   "a message and a bell ('both') or nothing ('off')."
 882         },
 883
 884         { .name = "visual-bell",
 885           .type = OPTIONS_TABLE_CHOICE,
 886           .scope = OPTIONS_TABLE_SESSION,
 887           .choices = options_table_visual_bell_list,
 888           .default_num = VISUAL_OFF,
 889           .text = "How bell alerts should be shown: a message ('on'), "
 890                   "a message and a bell ('both') or nothing ('off')."
 891         },
 892
 893         { .name = "visual-silence",
 894           .type = OPTIONS_TABLE_CHOICE,
 895           .scope = OPTIONS_TABLE_SESSION,
 896           .choices = options_table_visual_bell_list,
 897           .default_num = VISUAL_OFF,
 898           .text = "How silence alerts should be shown: a message ('on'), "
 899                   "a message and a bell ('both') or nothing ('off')."
 900         },
 901
 902         { .name = "word-separators",
 903           .type = OPTIONS_TABLE_STRING,
 904           .scope = OPTIONS_TABLE_SESSION,
 905           /*
 906            * The set of non-alphanumeric printable ASCII characters minus the
 907            * underscore.
 908            */
 909           .default_str = "!\"#$%&'()*+,-./:;<=>?@[\\]^`{|}~",
 910           .text = "Characters considered to separate words."
 911         },
 912
 913         /* Window options. */
 914         { .name = "aggressive-resize",
 915           .type = OPTIONS_TABLE_FLAG,
 916           .scope = OPTIONS_TABLE_WINDOW,
 917           .default_num = 0,
 918           .text = "When 'window-size' is 'smallest', whether the maximum size "
 919                   "of a window is the smallest attached session where it is "
 920                   "the current window ('on') or the smallest session it is "
 921                   "linked to ('off')."
 922         },
 923
 924         { .name = "allow-passthrough",
 925           .type = OPTIONS_TABLE_CHOICE,
 926           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
 927           .choices = options_table_allow_passthrough_list,
 928           .default_num = 0,
 929           .text = "Whether applications are allowed to use the escape sequence "
 930                   "to bypass tmux. Can be 'off' (disallowed), 'on' (allowed "
 931                   "if the pane is visible), or 'all' (allowed even if the pane "
 932                   "is invisible)."
 933         },
 934
 935         { .name = "allow-rename",
 936           .type = OPTIONS_TABLE_FLAG,
 937           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
 938           .default_num = 0,
 939           .text = "Whether applications are allowed to use the escape sequence "
 940                   "to rename windows."
 941         },
 942
 943         { .name = "allow-set-title",
 944           .type = OPTIONS_TABLE_FLAG,
 945           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
 946           .default_num = 1,
 947           .text = "Whether applications are allowed to use the escape sequence "
 948                   "to set the pane title."
 949         },
 950
 951         { .name = "alternate-screen",
 952           .type = OPTIONS_TABLE_FLAG,
 953           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
 954           .default_num = 1,
 955           .text = "Whether applications are allowed to use the alternate "
 956                   "screen."
 957         },
 958
 959         { .name = "automatic-rename",
 960           .type = OPTIONS_TABLE_FLAG,
 961           .scope = OPTIONS_TABLE_WINDOW,
 962           .default_num = 1,
 963           .text = "Whether windows are automatically renamed."
 964         },
 965
 966         { .name = "automatic-rename-format",
 967           .type = OPTIONS_TABLE_STRING,
 968           .scope = OPTIONS_TABLE_WINDOW,
 969           .default_str = "#{?pane_in_mode,[tmux],#{pane_current_command}}"
 970                          "#{?pane_dead,[dead],}",
 971           .text = "Format used to automatically rename windows."
 972         },
 973
 974         { .name = "clock-mode-colour",
 975           .type = OPTIONS_TABLE_COLOUR,
 976           .scope = OPTIONS_TABLE_WINDOW,
 977           .default_num = 4,
 978           .text = "Colour of the clock in clock mode."
 979         },
 980
 981         { .name = "clock-mode-style",
 982           .type = OPTIONS_TABLE_CHOICE,
 983           .scope = OPTIONS_TABLE_WINDOW,
 984           .choices = options_table_clock_mode_style_list,
 985           .default_num = 1,
 986           .text = "Time format of the clock in clock mode."
 987         },
 988
 989         { .name = "copy-mode-match-style",
 990           .type = OPTIONS_TABLE_STRING,
 991           .scope = OPTIONS_TABLE_WINDOW,
 992           .default_str = "bg=cyan,fg=black",
 993           .flags = OPTIONS_TABLE_IS_STYLE,
 994           .separator = ",",
 995           .text = "Style of search matches in copy mode."
 996         },
 997
 998         { .name = "copy-mode-current-match-style",
 999           .type = OPTIONS_TABLE_STRING,
1000           .scope = OPTIONS_TABLE_WINDOW,
1001           .default_str = "bg=magenta,fg=black",
1002           .flags = OPTIONS_TABLE_IS_STYLE,
1003           .separator = ",",
1004           .text = "Style of the current search match in copy mode."
1005         },
1006
1007         { .name = "copy-mode-mark-style",
1008           .type = OPTIONS_TABLE_STRING,
1009           .scope = OPTIONS_TABLE_WINDOW,
1010           .default_str = "bg=red,fg=black",
1011           .flags = OPTIONS_TABLE_IS_STYLE,
1012           .separator = ",",
1013           .text = "Style of the marked line in copy mode."
1014         },
1015
1016         { .name = "copy-mode-position-format",
1017           .type = OPTIONS_TABLE_STRING,
1018           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1019           .default_str = "#[align=right]"
1020                          "#{t/p:top_line_time}#{?#{e|>:#{top_line_time},0}, ,}"
1021                          "[#{scroll_position}/#{history_size}]"
1022                          "#{?search_timed_out, (timed out),"
1023                          "#{?search_count, (#{search_count}"
1024                          "#{?search_count_partial,+,} results),}}",
1025           .text = "Format of the position indicator in copy mode."
1026         },
1027
1028         { .name = "fill-character",
1029           .type = OPTIONS_TABLE_STRING,
1030           .scope = OPTIONS_TABLE_WINDOW,
1031           .default_str = "",
1032           .text = "Character used to fill unused parts of window."
1033         },
1034
1035         { .name = "main-pane-height",
1036           .type = OPTIONS_TABLE_STRING,
1037           .scope = OPTIONS_TABLE_WINDOW,
1038           .default_str = "24",
1039           .text = "Height of the main pane in the 'main-horizontal' layout. "
1040                   "This may be a percentage, for example '10%'."
1041         },
1042
1043         { .name = "main-pane-width",
1044           .type = OPTIONS_TABLE_STRING,
1045           .scope = OPTIONS_TABLE_WINDOW,
1046           .default_str = "80",
1047           .text = "Width of the main pane in the 'main-vertical' layout. "
1048                   "This may be a percentage, for example '10%'."
1049         },
1050
1051         { .name = "mode-keys",
1052           .type = OPTIONS_TABLE_CHOICE,
1053           .scope = OPTIONS_TABLE_WINDOW,
1054           .choices = options_table_mode_keys_list,
1055           .default_num = MODEKEY_EMACS,
1056           .text = "Key set used in copy mode."
1057         },
1058
1059         { .name = "mode-style",
1060           .type = OPTIONS_TABLE_STRING,
1061           .scope = OPTIONS_TABLE_WINDOW,
1062           .flags = OPTIONS_TABLE_IS_STYLE,
1063           .default_str = "bg=yellow,fg=black",
1064           .separator = ",",
1065           .text = "Style of indicators and highlighting in modes."
1066         },
1067
1068         { .name = "monitor-activity",
1069           .type = OPTIONS_TABLE_FLAG,
1070           .scope = OPTIONS_TABLE_WINDOW,
1071           .default_num = 0,
1072           .text = "Whether an alert is triggered by activity."
1073         },
1074
1075         { .name = "monitor-bell",
1076           .type = OPTIONS_TABLE_FLAG,
1077           .scope = OPTIONS_TABLE_WINDOW,
1078           .default_num = 1,
1079           .text = "Whether an alert is triggered by a bell."
1080         },
1081
1082         { .name = "monitor-silence",
1083           .type = OPTIONS_TABLE_NUMBER,
1084           .scope = OPTIONS_TABLE_WINDOW,
1085           .minimum = 0,
1086           .maximum = INT_MAX,
1087           .default_num = 0,
1088           .text = "Time after which an alert is triggered by silence. "
1089                   "Zero means no alert."
1090
1091         },
1092
1093         { .name = "other-pane-height",
1094           .type = OPTIONS_TABLE_STRING,
1095           .scope = OPTIONS_TABLE_WINDOW,
1096           .default_str = "0",
1097           .text = "Height of the other panes in the 'main-horizontal' layout. "
1098                   "This may be a percentage, for example '10%'."
1099         },
1100
1101         { .name = "other-pane-width",
1102           .type = OPTIONS_TABLE_STRING,
1103           .scope = OPTIONS_TABLE_WINDOW,
1104           .default_str = "0",
1105           .text = "Height of the other panes in the 'main-vertical' layout. "
1106                   "This may be a percentage, for example '10%'."
1107         },
1108
1109         { .name = "pane-active-border-style",
1110           .type = OPTIONS_TABLE_STRING,
1111           .scope = OPTIONS_TABLE_WINDOW,
1112           .default_str = "#{?pane_in_mode,fg=yellow,#{?synchronize-panes,fg=red,fg=green}}",
1113           .flags = OPTIONS_TABLE_IS_STYLE,
1114           .separator = ",",
1115           .text = "Style of the active pane border."
1116         },
1117
1118         { .name = "pane-base-index",
1119           .type = OPTIONS_TABLE_NUMBER,
1120           .scope = OPTIONS_TABLE_WINDOW,
1121           .minimum = 0,
1122           .maximum = USHRT_MAX,
1123           .default_num = 0,
1124           .text = "Index of the first pane in each window."
1125         },
1126
1127         { .name = "pane-border-format",
1128           .type = OPTIONS_TABLE_STRING,
1129           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1130           .default_str = "#{?pane_active,#[reverse],}#{pane_index}#[default] "
1131                          "\"#{pane_title}\"",
1132           .text = "Format of text in the pane status lines."
1133         },
1134
1135         { .name = "pane-border-indicators",
1136           .type = OPTIONS_TABLE_CHOICE,
1137           .scope = OPTIONS_TABLE_WINDOW,
1138           .choices = options_table_pane_border_indicators_list,
1139           .default_num = PANE_BORDER_COLOUR,
1140           .text = "Whether to indicate the active pane by colouring border or "
1141                   "displaying arrow markers."
1142         },
1143
1144         { .name = "pane-border-lines",
1145           .type = OPTIONS_TABLE_CHOICE,
1146           .scope = OPTIONS_TABLE_WINDOW,
1147           .choices = options_table_pane_border_lines_list,
1148           .default_num = PANE_LINES_SINGLE,
1149           .text = "Type of characters used to draw pane border lines. Some of "
1150                   "these are only supported on terminals with UTF-8 support."
1151         },
1152
1153         { .name = "pane-border-status",
1154           .type = OPTIONS_TABLE_CHOICE,
1155           .scope = OPTIONS_TABLE_WINDOW,
1156           .choices = options_table_pane_status_list,
1157           .default_num = PANE_STATUS_OFF,
1158           .text = "Position of the pane status lines."
1159         },
1160
1161         { .name = "pane-border-style",
1162           .type = OPTIONS_TABLE_STRING,
1163           .scope = OPTIONS_TABLE_WINDOW,
1164           .default_str = "default",
1165           .flags = OPTIONS_TABLE_IS_STYLE,
1166           .separator = ",",
1167           .text = "Style of the pane status lines."
1168         },
1169
1170         { .name = "pane-colours",
1171           .type = OPTIONS_TABLE_COLOUR,
1172           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1173           .default_str = "",
1174           .flags = OPTIONS_TABLE_IS_ARRAY,
1175           .text = "The default colour palette for colours zero to 255."
1176         },
1177
1178         { .name = "pane-scrollbars",
1179           .type = OPTIONS_TABLE_CHOICE,
1180           .scope = OPTIONS_TABLE_WINDOW,
1181           .choices = options_table_pane_scrollbars_list,
1182           .default_num = PANE_SCROLLBARS_OFF,
1183           .text = "Pane scrollbar state."
1184         },
1185
1186         { .name = "pane-scrollbars-style",
1187           .type = OPTIONS_TABLE_STRING,
1188           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1189           .default_str = "bg=black,fg=white,width=1,pad=0",
1190           .flags = OPTIONS_TABLE_IS_STYLE,
1191           .separator = ",",
1192           .text = "Style of the pane scrollbar."
1193         },
1194
1195         { .name = "pane-scrollbars-position",
1196           .type = OPTIONS_TABLE_CHOICE,
1197           .scope = OPTIONS_TABLE_WINDOW,
1198           .choices = options_table_pane_scrollbars_position_list,
1199           .default_num = PANE_SCROLLBARS_RIGHT,
1200           .text = "Pane scrollbar position."
1201         },
1202
1203         { .name = "popup-style",
1204           .type = OPTIONS_TABLE_STRING,
1205           .scope = OPTIONS_TABLE_WINDOW,
1206           .default_str = "default",
1207           .flags = OPTIONS_TABLE_IS_STYLE,
1208           .separator = ",",
1209           .text = "Default style of popups."
1210         },
1211
1212         { .name = "popup-border-style",
1213           .type = OPTIONS_TABLE_STRING,
1214           .scope = OPTIONS_TABLE_WINDOW,
1215           .default_str = "default",
1216           .flags = OPTIONS_TABLE_IS_STYLE,
1217           .separator = ",",
1218           .text = "Default style of popup borders."
1219         },
1220
1221         { .name = "popup-border-lines",
1222           .type = OPTIONS_TABLE_CHOICE,
1223           .scope = OPTIONS_TABLE_WINDOW,
1224           .choices = options_table_popup_border_lines_list,
1225           .default_num = BOX_LINES_SINGLE,
1226           .text = "Type of characters used to draw popup border lines. Some of "
1227                   "these are only supported on terminals with UTF-8 support."
1228         },
1229
1230         { .name = "remain-on-exit",
1231           .type = OPTIONS_TABLE_CHOICE,
1232           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1233           .choices = options_table_remain_on_exit_list,
1234           .default_num = 0,
1235           .text = "Whether panes should remain ('on') or be automatically "
1236                   "killed ('off' or 'failed') when the program inside exits."
1237         },
1238
1239         { .name = "remain-on-exit-format",
1240           .type = OPTIONS_TABLE_STRING,
1241           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1242           .default_str = "Pane is dead ("
1243                          "#{?#{!=:#{pane_dead_status},},"
1244                          "status #{pane_dead_status},}"
1245                          "#{?#{!=:#{pane_dead_signal},},"
1246                          "signal #{pane_dead_signal},}, "
1247                          "#{t:pane_dead_time})",
1248           .text = "Message shown after the program in a pane has exited, if "
1249                   "remain-on-exit is enabled."
1250         },
1251
1252         { .name = "scroll-on-clear",
1253           .type = OPTIONS_TABLE_FLAG,
1254           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1255           .default_num = 1,
1256           .text = "Whether the contents of the screen should be scrolled into"
1257                   "history when clearing the whole screen."
1258         },
1259
1260         { .name = "synchronize-panes",
1261           .type = OPTIONS_TABLE_FLAG,
1262           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1263           .default_num = 0,
1264           .text = "Whether typing should be sent to all panes simultaneously."
1265         },
1266
1267         { .name = "window-active-style",
1268           .type = OPTIONS_TABLE_STRING,
1269           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1270           .default_str = "default",
1271           .flags = OPTIONS_TABLE_IS_STYLE,
1272           .separator = ",",
1273           .text = "Default style of the active pane."
1274         },
1275
1276         { .name = "window-size",
1277           .type = OPTIONS_TABLE_CHOICE,
1278           .scope = OPTIONS_TABLE_WINDOW,
1279           .choices = options_table_window_size_list,
1280           .default_num = WINDOW_SIZE_LATEST,
1281           .text = "How window size is calculated. "
1282                   "'latest' uses the size of the most recently used client, "
1283                   "'largest' the largest client, 'smallest' the smallest "
1284                   "client and 'manual' a size set by the 'resize-window' "
1285                   "command."
1286         },
1287
1288         { .name = "window-style",
1289           .type = OPTIONS_TABLE_STRING,
1290           .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1291           .default_str = "default",
1292           .flags = OPTIONS_TABLE_IS_STYLE,
1293           .separator = ",",
1294           .text = "Default style of panes that are not the active pane."
1295         },
1296
1297         { .name = "window-status-activity-style",
1298           .type = OPTIONS_TABLE_STRING,
1299           .scope = OPTIONS_TABLE_WINDOW,
1300           .default_str = "reverse",
1301           .flags = OPTIONS_TABLE_IS_STYLE,
1302           .separator = ",",
1303           .text = "Style of windows in the status line with an activity alert."
1304         },
1305
1306         { .name = "window-status-bell-style",
1307           .type = OPTIONS_TABLE_STRING,
1308           .scope = OPTIONS_TABLE_WINDOW,
1309           .default_str = "reverse",
1310           .flags = OPTIONS_TABLE_IS_STYLE,
1311           .separator = ",",
1312           .text = "Style of windows in the status line with a bell alert."
1313         },
1314
1315         { .name = "window-status-current-format",
1316           .type = OPTIONS_TABLE_STRING,
1317           .scope = OPTIONS_TABLE_WINDOW,
1318           .default_str = "#I:#W#{?window_flags,#{window_flags}, }",
1319           .text = "Format of the current window in the status line."
1320         },
1321
1322         { .name = "window-status-current-style",
1323           .type = OPTIONS_TABLE_STRING,
1324           .scope = OPTIONS_TABLE_WINDOW,
1325           .default_str = "default",
1326           .flags = OPTIONS_TABLE_IS_STYLE,
1327           .separator = ",",
1328           .text = "Style of the current window in the status line."
1329         },
1330
1331         { .name = "window-status-format",
1332           .type = OPTIONS_TABLE_STRING,
1333           .scope = OPTIONS_TABLE_WINDOW,
1334           .default_str = "#I:#W#{?window_flags,#{window_flags}, }",
1335           .text = "Format of windows in the status line, except the current "
1336                   "window."
1337         },
1338
1339         { .name = "window-status-last-style",
1340           .type = OPTIONS_TABLE_STRING,
1341           .scope = OPTIONS_TABLE_WINDOW,
1342           .default_str = "default",
1343           .flags = OPTIONS_TABLE_IS_STYLE,
1344           .separator = ",",
1345           .text = "Style of the last window in the status line."
1346         },
1347
1348         { .name = "window-status-separator",
1349           .type = OPTIONS_TABLE_STRING,
1350           .scope = OPTIONS_TABLE_WINDOW,
1351           .default_str = " ",
1352           .text = "Separator between windows in the status line."
1353         },
1354
1355         { .name = "window-status-style",
1356           .type = OPTIONS_TABLE_STRING,
1357           .scope = OPTIONS_TABLE_WINDOW,
1358           .default_str = "default",
1359           .flags = OPTIONS_TABLE_IS_STYLE,
1360           .separator = ",",
1361           .text = "Style of windows in the status line, except the current and "
1362                   "last windows."
1363         },
1364
1365         { .name = "wrap-search",
1366           .type = OPTIONS_TABLE_FLAG,
1367           .scope = OPTIONS_TABLE_WINDOW,
1368           .default_num = 1,
1369           .text = "Whether searching in copy mode should wrap at the top or "
1370                   "bottom."
1371         },
1372
1373         { .name = "xterm-keys", /* no longer used */
1374           .type = OPTIONS_TABLE_FLAG,
1375           .scope = OPTIONS_TABLE_WINDOW,
1376           .default_num = 1,
1377           .text = "Whether xterm-style function key sequences should be sent. "
1378                   "This option is no longer used."
1379         },
1380
1381         /* Hook options. */
1382         OPTIONS_TABLE_HOOK("after-bind-key", ""),
1383         OPTIONS_TABLE_HOOK("after-capture-pane", ""),
1384         OPTIONS_TABLE_HOOK("after-copy-mode", ""),
1385         OPTIONS_TABLE_HOOK("after-display-message", ""),
1386         OPTIONS_TABLE_HOOK("after-display-panes", ""),
1387         OPTIONS_TABLE_HOOK("after-kill-pane", ""),
1388         OPTIONS_TABLE_HOOK("after-list-buffers", ""),
1389         OPTIONS_TABLE_HOOK("after-list-clients", ""),
1390         OPTIONS_TABLE_HOOK("after-list-keys", ""),
1391         OPTIONS_TABLE_HOOK("after-list-panes", ""),
1392         OPTIONS_TABLE_HOOK("after-list-sessions", ""),
1393         OPTIONS_TABLE_HOOK("after-list-windows", ""),
1394         OPTIONS_TABLE_HOOK("after-load-buffer", ""),
1395         OPTIONS_TABLE_HOOK("after-lock-server", ""),
1396         OPTIONS_TABLE_HOOK("after-new-session", ""),
1397         OPTIONS_TABLE_HOOK("after-new-window", ""),
1398         OPTIONS_TABLE_HOOK("after-paste-buffer", ""),
1399         OPTIONS_TABLE_HOOK("after-pipe-pane", ""),
1400         OPTIONS_TABLE_HOOK("after-queue", ""),
1401         OPTIONS_TABLE_HOOK("after-refresh-client", ""),
1402         OPTIONS_TABLE_HOOK("after-rename-session", ""),
1403         OPTIONS_TABLE_HOOK("after-rename-window", ""),
1404         OPTIONS_TABLE_HOOK("after-resize-pane", ""),
1405         OPTIONS_TABLE_HOOK("after-resize-window", ""),
1406         OPTIONS_TABLE_HOOK("after-save-buffer", ""),
1407         OPTIONS_TABLE_HOOK("after-select-layout", ""),
1408         OPTIONS_TABLE_HOOK("after-select-pane", ""),
1409         OPTIONS_TABLE_HOOK("after-select-window", ""),
1410         OPTIONS_TABLE_HOOK("after-send-keys", ""),
1411         OPTIONS_TABLE_HOOK("after-set-buffer", ""),
1412         OPTIONS_TABLE_HOOK("after-set-environment", ""),
1413         OPTIONS_TABLE_HOOK("after-set-hook", ""),
1414         OPTIONS_TABLE_HOOK("after-set-option", ""),
1415         OPTIONS_TABLE_HOOK("after-show-environment", ""),
1416         OPTIONS_TABLE_HOOK("after-show-messages", ""),
1417         OPTIONS_TABLE_HOOK("after-show-options", ""),
1418         OPTIONS_TABLE_HOOK("after-split-window", ""),
1419         OPTIONS_TABLE_HOOK("after-unbind-key", ""),
1420         OPTIONS_TABLE_HOOK("alert-activity", ""),
1421         OPTIONS_TABLE_HOOK("alert-bell", ""),
1422         OPTIONS_TABLE_HOOK("alert-silence", ""),
1423         OPTIONS_TABLE_HOOK("client-active", ""),
1424         OPTIONS_TABLE_HOOK("client-attached", ""),
1425         OPTIONS_TABLE_HOOK("client-detached", ""),
1426         OPTIONS_TABLE_HOOK("client-focus-in", ""),
1427         OPTIONS_TABLE_HOOK("client-focus-out", ""),
1428         OPTIONS_TABLE_HOOK("client-resized", ""),
1429         OPTIONS_TABLE_HOOK("client-session-changed", ""),
1430         OPTIONS_TABLE_HOOK("command-error", ""),
1431         OPTIONS_TABLE_PANE_HOOK("pane-died", ""),
1432         OPTIONS_TABLE_PANE_HOOK("pane-exited", ""),
1433         OPTIONS_TABLE_PANE_HOOK("pane-focus-in", ""),
1434         OPTIONS_TABLE_PANE_HOOK("pane-focus-out", ""),
1435         OPTIONS_TABLE_PANE_HOOK("pane-mode-changed", ""),
1436         OPTIONS_TABLE_PANE_HOOK("pane-set-clipboard", ""),
1437         OPTIONS_TABLE_PANE_HOOK("pane-title-changed", ""),
1438         OPTIONS_TABLE_HOOK("session-closed", ""),
1439         OPTIONS_TABLE_HOOK("session-created", ""),
1440         OPTIONS_TABLE_HOOK("session-renamed", ""),
1441         OPTIONS_TABLE_HOOK("session-window-changed", ""),
1442         OPTIONS_TABLE_WINDOW_HOOK("window-layout-changed", ""),
1443         OPTIONS_TABLE_HOOK("window-linked", ""),
1444         OPTIONS_TABLE_WINDOW_HOOK("window-pane-changed", ""),
1445         OPTIONS_TABLE_WINDOW_HOOK("window-renamed", ""),
1446         OPTIONS_TABLE_WINDOW_HOOK("window-resized", ""),
1447         OPTIONS_TABLE_HOOK("window-unlinked", ""),
1448
1449         { .name = NULL }
1450 };