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