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