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