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