xref: /openbsd-src/usr.bin/tmux/options-table.c (revision f90ef06a3045119dcc88b72d8b98ca60e3c00d5a)
1 /* $OpenBSD: options-table.c,v 1.166 2023/08/08 08:08:47 nicm Exp $ */
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", 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-border-style",
340 	  .type = OPTIONS_TABLE_STRING,
341 	  .scope = OPTIONS_TABLE_WINDOW,
342 	  .default_str = "default",
343 	  .flags = OPTIONS_TABLE_IS_STYLE,
344 	  .separator = ",",
345 	  .text = "Default style of menu borders."
346 	},
347 
348 	{ .name = "menu-border-lines",
349 	  .type = OPTIONS_TABLE_CHOICE,
350 	  .scope = OPTIONS_TABLE_WINDOW,
351 	  .choices = options_table_popup_border_lines_list,
352 	  .default_num = BOX_LINES_SINGLE,
353 	  .text = "Type of characters used to draw menu border lines. Some of "
354 	          "these are only supported on terminals with UTF-8 support."
355 	},
356 
357 	{ .name = "message-limit",
358 	  .type = OPTIONS_TABLE_NUMBER,
359 	  .scope = OPTIONS_TABLE_SERVER,
360 	  .minimum = 0,
361 	  .maximum = INT_MAX,
362 	  .default_num = 1000,
363 	  .text = "Maximum number of server messages to keep."
364 	},
365 
366 	{ .name = "prompt-history-limit",
367 	  .type = OPTIONS_TABLE_NUMBER,
368 	  .scope = OPTIONS_TABLE_SERVER,
369 	  .minimum = 0,
370 	  .maximum = INT_MAX,
371 	  .default_num = 100,
372 	  .text = "Maximum number of commands to keep in history."
373 	},
374 
375 	{ .name = "set-clipboard",
376 	  .type = OPTIONS_TABLE_CHOICE,
377 	  .scope = OPTIONS_TABLE_SERVER,
378 	  .choices = options_table_set_clipboard_list,
379 	  .default_num = 1,
380 	  .text = "Whether to attempt to set the system clipboard ('on' or "
381 		  "'external') and whether to allow applications to create "
382 		  "paste buffers with an escape sequence ('on' only)."
383 	},
384 
385 	{ .name = "terminal-overrides",
386 	  .type = OPTIONS_TABLE_STRING,
387 	  .scope = OPTIONS_TABLE_SERVER,
388 	  .flags = OPTIONS_TABLE_IS_ARRAY,
389 	  .default_str = "",
390 	  .separator = ",",
391 	  .text = "List of terminal capabilities overrides."
392 	},
393 
394 	{ .name = "terminal-features",
395 	  .type = OPTIONS_TABLE_STRING,
396 	  .scope = OPTIONS_TABLE_SERVER,
397 	  .flags = OPTIONS_TABLE_IS_ARRAY,
398 	  .default_str = "xterm*:clipboard:ccolour:cstyle:focus:title,"
399 			 "screen*:title,"
400 	                 "rxvt*:ignorefkeys",
401 	  .separator = ",",
402 	  .text = "List of terminal features, used if they cannot be "
403 		  "automatically detected."
404 	},
405 
406 	{ .name = "user-keys",
407 	  .type = OPTIONS_TABLE_STRING,
408 	  .scope = OPTIONS_TABLE_SERVER,
409 	  .flags = OPTIONS_TABLE_IS_ARRAY,
410 	  .default_str = "",
411 	  .separator = ",",
412 	  .text = "User key assignments. "
413 		  "Each sequence in the list is translated into a key: "
414 		  "'User0', 'User1' and so on."
415 	},
416 
417 	/* Session options. */
418 	{ .name = "activity-action",
419 	  .type = OPTIONS_TABLE_CHOICE,
420 	  .scope = OPTIONS_TABLE_SESSION,
421 	  .choices = options_table_bell_action_list,
422 	  .default_num = ALERT_OTHER,
423 	  .text = "Action to take on an activity alert."
424 	},
425 
426 	{ .name = "assume-paste-time",
427 	  .type = OPTIONS_TABLE_NUMBER,
428 	  .scope = OPTIONS_TABLE_SESSION,
429 	  .minimum = 0,
430 	  .maximum = INT_MAX,
431 	  .default_num = 1,
432 	  .unit = "milliseconds",
433 	  .text = "Maximum time between input to assume it is pasting rather "
434 		  "than typing."
435 	},
436 
437 	{ .name = "base-index",
438 	  .type = OPTIONS_TABLE_NUMBER,
439 	  .scope = OPTIONS_TABLE_SESSION,
440 	  .minimum = 0,
441 	  .maximum = INT_MAX,
442 	  .default_num = 0,
443 	  .text = "Default index of the first window in each session."
444 	},
445 
446 	{ .name = "bell-action",
447 	  .type = OPTIONS_TABLE_CHOICE,
448 	  .scope = OPTIONS_TABLE_SESSION,
449 	  .choices = options_table_bell_action_list,
450 	  .default_num = ALERT_ANY,
451 	  .text = "Action to take on a bell alert."
452 	},
453 
454 	{ .name = "default-command",
455 	  .type = OPTIONS_TABLE_STRING,
456 	  .scope = OPTIONS_TABLE_SESSION,
457 	  .default_str = "",
458 	  .text = "Default command to run in new panes. If empty, a shell is "
459 		  "started."
460 	},
461 
462 	{ .name = "default-shell",
463 	  .type = OPTIONS_TABLE_STRING,
464 	  .scope = OPTIONS_TABLE_SESSION,
465 	  .default_str = _PATH_BSHELL,
466 	  .text = "Location of default shell."
467 	},
468 
469 	{ .name = "default-size",
470 	  .type = OPTIONS_TABLE_STRING,
471 	  .scope = OPTIONS_TABLE_SESSION,
472 	  .pattern = "[0-9]*x[0-9]*",
473 	  .default_str = "80x24",
474 	  .text = "Initial size of new sessions."
475 	},
476 
477 	{ .name = "destroy-unattached",
478 	  .type = OPTIONS_TABLE_FLAG,
479 	  .scope = OPTIONS_TABLE_SESSION,
480 	  .default_num = 0,
481 	  .text = "Whether to destroy sessions when they have no attached "
482 		  "clients."
483 	},
484 
485 	{ .name = "detach-on-destroy",
486 	  .type = OPTIONS_TABLE_CHOICE,
487 	  .scope = OPTIONS_TABLE_SESSION,
488 	  .choices = options_table_detach_on_destroy_list,
489 	  .default_num = 1,
490 	  .text = "Whether to detach when a session is destroyed, or switch "
491 		  "the client to another session if any exist."
492 	},
493 
494 	{ .name = "display-panes-active-colour",
495 	  .type = OPTIONS_TABLE_COLOUR,
496 	  .scope = OPTIONS_TABLE_SESSION,
497 	  .default_num = 1,
498 	  .text = "Colour of the active pane for 'display-panes'."
499 	},
500 
501 	{ .name = "display-panes-colour",
502 	  .type = OPTIONS_TABLE_COLOUR,
503 	  .scope = OPTIONS_TABLE_SESSION,
504 	  .default_num = 4,
505 	  .text = "Colour of not active panes for 'display-panes'."
506 	},
507 
508 	{ .name = "display-panes-time",
509 	  .type = OPTIONS_TABLE_NUMBER,
510 	  .scope = OPTIONS_TABLE_SESSION,
511 	  .minimum = 1,
512 	  .maximum = INT_MAX,
513 	  .default_num = 1000,
514 	  .unit = "milliseconds",
515 	  .text = "Time for which 'display-panes' should show pane numbers."
516 	},
517 
518 	{ .name = "display-time",
519 	  .type = OPTIONS_TABLE_NUMBER,
520 	  .scope = OPTIONS_TABLE_SESSION,
521 	  .minimum = 0,
522 	  .maximum = INT_MAX,
523 	  .default_num = 750,
524 	  .unit = "milliseconds",
525 	  .text = "Time for which status line messages should appear."
526 	},
527 
528 	{ .name = "history-limit",
529 	  .type = OPTIONS_TABLE_NUMBER,
530 	  .scope = OPTIONS_TABLE_SESSION,
531 	  .minimum = 0,
532 	  .maximum = INT_MAX,
533 	  .default_num = 2000,
534 	  .unit = "lines",
535 	  .text = "Maximum number of lines to keep in the history for each "
536 		  "pane. "
537 		  "If changed, the new value applies only to new panes."
538 	},
539 
540 	{ .name = "key-table",
541 	  .type = OPTIONS_TABLE_STRING,
542 	  .scope = OPTIONS_TABLE_SESSION,
543 	  .default_str = "root",
544 	  .text = "Default key table. "
545 		  "Key presses are first looked up in this table."
546 	},
547 
548 	{ .name = "lock-after-time",
549 	  .type = OPTIONS_TABLE_NUMBER,
550 	  .scope = OPTIONS_TABLE_SESSION,
551 	  .minimum = 0,
552 	  .maximum = INT_MAX,
553 	  .default_num = 0,
554 	  .unit = "seconds",
555 	  .text = "Time after which a client is locked if not used."
556 	},
557 
558 	{ .name = "lock-command",
559 	  .type = OPTIONS_TABLE_STRING,
560 	  .scope = OPTIONS_TABLE_SESSION,
561 	  .default_str = "lock -np",
562 	  .text = "Shell command to run to lock a client."
563 	},
564 
565 	{ .name = "message-command-style",
566 	  .type = OPTIONS_TABLE_STRING,
567 	  .scope = OPTIONS_TABLE_SESSION,
568 	  .default_str = "bg=black,fg=yellow",
569 	  .flags = OPTIONS_TABLE_IS_STYLE,
570 	  .separator = ",",
571 	  .text = "Style of the command prompt when in command mode, if "
572 		  "'mode-keys' is set to 'vi'."
573 	},
574 
575 	{ .name = "message-line",
576 	  .type = OPTIONS_TABLE_CHOICE,
577 	  .scope = OPTIONS_TABLE_SESSION,
578 	  .choices = options_table_message_line_list,
579 	  .default_num = 0,
580 	  .text = "Position (line) of messages and the command prompt."
581 	},
582 
583 	{ .name = "message-style",
584 	  .type = OPTIONS_TABLE_STRING,
585 	  .scope = OPTIONS_TABLE_SESSION,
586 	  .default_str = "bg=yellow,fg=black",
587 	  .flags = OPTIONS_TABLE_IS_STYLE,
588 	  .separator = ",",
589 	  .text = "Style of messages and the command prompt."
590 	},
591 
592 	{ .name = "mouse",
593 	  .type = OPTIONS_TABLE_FLAG,
594 	  .scope = OPTIONS_TABLE_SESSION,
595 	  .default_num = 0,
596 	  .text = "Whether the mouse is recognised and mouse key bindings are "
597 		  "executed. "
598 		  "Applications inside panes can use the mouse even when 'off'."
599 	},
600 
601 	{ .name = "prefix",
602 	  .type = OPTIONS_TABLE_KEY,
603 	  .scope = OPTIONS_TABLE_SESSION,
604 	  .default_num = '\002',
605 	  .text = "The prefix key."
606 	},
607 
608 	{ .name = "prefix2",
609 	  .type = OPTIONS_TABLE_KEY,
610 	  .scope = OPTIONS_TABLE_SESSION,
611 	  .default_num = KEYC_NONE,
612 	  .text = "A second prefix key."
613 	},
614 
615 	{ .name = "renumber-windows",
616 	  .type = OPTIONS_TABLE_FLAG,
617 	  .scope = OPTIONS_TABLE_SESSION,
618 	  .default_num = 0,
619 	  .text = "Whether windows are automatically renumbered rather than "
620 		  "leaving gaps."
621 	},
622 
623 	{ .name = "repeat-time",
624 	  .type = OPTIONS_TABLE_NUMBER,
625 	  .scope = OPTIONS_TABLE_SESSION,
626 	  .minimum = 0,
627 	  .maximum = SHRT_MAX,
628 	  .default_num = 500,
629 	  .unit = "milliseconds",
630 	  .text = "Time to wait for a key binding to repeat, if it is bound "
631 		  "with the '-r' flag."
632 	},
633 
634 	{ .name = "set-titles",
635 	  .type = OPTIONS_TABLE_FLAG,
636 	  .scope = OPTIONS_TABLE_SESSION,
637 	  .default_num = 0,
638 	  .text = "Whether to set the terminal title, if supported."
639 	},
640 
641 	{ .name = "set-titles-string",
642 	  .type = OPTIONS_TABLE_STRING,
643 	  .scope = OPTIONS_TABLE_SESSION,
644 	  .default_str = "#S:#I:#W - \"#T\" #{session_alerts}",
645 	  .text = "Format of the terminal title to set."
646 	},
647 
648 	{ .name = "silence-action",
649 	  .type = OPTIONS_TABLE_CHOICE,
650 	  .scope = OPTIONS_TABLE_SESSION,
651 	  .choices = options_table_bell_action_list,
652 	  .default_num = ALERT_OTHER,
653 	  .text = "Action to take on a silence alert."
654 	},
655 
656 	{ .name = "status",
657 	  .type = OPTIONS_TABLE_CHOICE,
658 	  .scope = OPTIONS_TABLE_SESSION,
659 	  .choices = options_table_status_list,
660 	  .default_num = 1,
661 	  .text = "Number of lines in the status line."
662 	},
663 
664 	{ .name = "status-bg",
665 	  .type = OPTIONS_TABLE_COLOUR,
666 	  .scope = OPTIONS_TABLE_SESSION,
667 	  .default_num = 8,
668 	  .text = "Background colour of the status line. This option is "
669 		  "deprecated, use 'status-style' instead."
670 	},
671 
672 	{ .name = "status-fg",
673 	  .type = OPTIONS_TABLE_COLOUR,
674 	  .scope = OPTIONS_TABLE_SESSION,
675 	  .default_num = 8,
676 	  .text = "Foreground colour of the status line. This option is "
677 		  "deprecated, use 'status-style' instead."
678 	},
679 
680 	{ .name = "status-format",
681 	  .type = OPTIONS_TABLE_STRING,
682 	  .scope = OPTIONS_TABLE_SESSION,
683 	  .flags = OPTIONS_TABLE_IS_ARRAY,
684 	  .default_arr = options_table_status_format_default,
685 	  .text = "Formats for the status lines. "
686 		  "Each array member is the format for one status line. "
687 		  "The default status line is made up of several components "
688 		  "which may be configured individually with other options such "
689 		  "as 'status-left'."
690 	},
691 
692 	{ .name = "status-interval",
693 	  .type = OPTIONS_TABLE_NUMBER,
694 	  .scope = OPTIONS_TABLE_SESSION,
695 	  .minimum = 0,
696 	  .maximum = INT_MAX,
697 	  .default_num = 15,
698 	  .unit = "seconds",
699 	  .text = "Number of seconds between status line updates."
700 	},
701 
702 	{ .name = "status-justify",
703 	  .type = OPTIONS_TABLE_CHOICE,
704 	  .scope = OPTIONS_TABLE_SESSION,
705 	  .choices = options_table_status_justify_list,
706 	  .default_num = 0,
707 	  .text = "Position of the window list in the status line."
708 	},
709 
710 	{ .name = "status-keys",
711 	  .type = OPTIONS_TABLE_CHOICE,
712 	  .scope = OPTIONS_TABLE_SESSION,
713 	  .choices = options_table_status_keys_list,
714 	  .default_num = MODEKEY_EMACS,
715 	  .text = "Key set to use at the command prompt."
716 	},
717 
718 	{ .name = "status-left",
719 	  .type = OPTIONS_TABLE_STRING,
720 	  .scope = OPTIONS_TABLE_SESSION,
721 	  .default_str = "[#{session_name}] ",
722 	  .text = "Contents of the left side of the status line."
723 	},
724 
725 	{ .name = "status-left-length",
726 	  .type = OPTIONS_TABLE_NUMBER,
727 	  .scope = OPTIONS_TABLE_SESSION,
728 	  .minimum = 0,
729 	  .maximum = SHRT_MAX,
730 	  .default_num = 10,
731 	  .text = "Maximum width of the left side of the status line."
732 	},
733 
734 	{ .name = "status-left-style",
735 	  .type = OPTIONS_TABLE_STRING,
736 	  .scope = OPTIONS_TABLE_SESSION,
737 	  .default_str = "default",
738 	  .flags = OPTIONS_TABLE_IS_STYLE,
739 	  .separator = ",",
740 	  .text = "Style of the left side of the status line."
741 	},
742 
743 	{ .name = "status-position",
744 	  .type = OPTIONS_TABLE_CHOICE,
745 	  .scope = OPTIONS_TABLE_SESSION,
746 	  .choices = options_table_status_position_list,
747 	  .default_num = 1,
748 	  .text = "Position of the status line."
749 	},
750 
751 	{ .name = "status-right",
752 	  .type = OPTIONS_TABLE_STRING,
753 	  .scope = OPTIONS_TABLE_SESSION,
754 	  .default_str = "#{?window_bigger,"
755 			 "[#{window_offset_x}#,#{window_offset_y}] ,}"
756 			 "\"#{=21:pane_title}\" %H:%M %d-%b-%y",
757 	  .text = "Contents of the right side of the status line."
758 
759 	},
760 
761 	{ .name = "status-right-length",
762 	  .type = OPTIONS_TABLE_NUMBER,
763 	  .scope = OPTIONS_TABLE_SESSION,
764 	  .minimum = 0,
765 	  .maximum = SHRT_MAX,
766 	  .default_num = 40,
767 	  .text = "Maximum width of the right side of the status line."
768 	},
769 
770 	{ .name = "status-right-style",
771 	  .type = OPTIONS_TABLE_STRING,
772 	  .scope = OPTIONS_TABLE_SESSION,
773 	  .default_str = "default",
774 	  .flags = OPTIONS_TABLE_IS_STYLE,
775 	  .separator = ",",
776 	  .text = "Style of the right side of the status line."
777 	},
778 
779 	{ .name = "status-style",
780 	  .type = OPTIONS_TABLE_STRING,
781 	  .scope = OPTIONS_TABLE_SESSION,
782 	  .default_str = "bg=green,fg=black",
783 	  .flags = OPTIONS_TABLE_IS_STYLE,
784 	  .separator = ",",
785 	  .text = "Style of the status line."
786 	},
787 
788 	{ .name = "update-environment",
789 	  .type = OPTIONS_TABLE_STRING,
790 	  .scope = OPTIONS_TABLE_SESSION,
791 	  .flags = OPTIONS_TABLE_IS_ARRAY,
792 	  .default_str = "DISPLAY KRB5CCNAME SSH_ASKPASS SSH_AUTH_SOCK "
793 			 "SSH_AGENT_PID SSH_CONNECTION WINDOWID XAUTHORITY",
794 	  .text = "List of environment variables to update in the session "
795 		  "environment when a client is attached."
796 	},
797 
798 	{ .name = "visual-activity",
799 	  .type = OPTIONS_TABLE_CHOICE,
800 	  .scope = OPTIONS_TABLE_SESSION,
801 	  .choices = options_table_visual_bell_list,
802 	  .default_num = VISUAL_OFF,
803 	  .text = "How activity alerts should be shown: a message ('on'), "
804 		  "a message and a bell ('both') or nothing ('off')."
805 	},
806 
807 	{ .name = "visual-bell",
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 bell alerts should be shown: a message ('on'), "
813 		  "a message and a bell ('both') or nothing ('off')."
814 	},
815 
816 	{ .name = "visual-silence",
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 silence alerts should be shown: a message ('on'), "
822 		  "a message and a bell ('both') or nothing ('off')."
823 	},
824 
825 	{ .name = "word-separators",
826 	  .type = OPTIONS_TABLE_STRING,
827 	  .scope = OPTIONS_TABLE_SESSION,
828 	  /*
829 	   * The set of non-alphanumeric printable ASCII characters minus the
830 	   * underscore.
831 	   */
832 	  .default_str = "!\"#$%&'()*+,-./:;<=>?@[\\]^`{|}~",
833 	  .text = "Characters considered to separate words."
834 	},
835 
836 	/* Window options. */
837 	{ .name = "aggressive-resize",
838 	  .type = OPTIONS_TABLE_FLAG,
839 	  .scope = OPTIONS_TABLE_WINDOW,
840 	  .default_num = 0,
841 	  .text = "When 'window-size' is 'smallest', whether the maximum size "
842 		  "of a window is the smallest attached session where it is "
843 		  "the current window ('on') or the smallest session it is "
844 		  "linked to ('off')."
845 	},
846 
847 	{ .name = "allow-passthrough",
848 	  .type = OPTIONS_TABLE_CHOICE,
849 	  .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
850 	  .choices = options_table_allow_passthrough_list,
851 	  .default_num = 0,
852 	  .text = "Whether applications are allowed to use the escape sequence "
853 		  "to bypass tmux. Can be 'off' (disallowed), 'on' (allowed "
854 		  "if the pane is visible), or 'all' (allowed even if the pane "
855 		  "is invisible)."
856 	},
857 
858 	{ .name = "allow-rename",
859 	  .type = OPTIONS_TABLE_FLAG,
860 	  .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
861 	  .default_num = 0,
862 	  .text = "Whether applications are allowed to use the escape sequence "
863 		  "to rename windows."
864 	},
865 
866 	{ .name = "alternate-screen",
867 	  .type = OPTIONS_TABLE_FLAG,
868 	  .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
869 	  .default_num = 1,
870 	  .text = "Whether applications are allowed to use the alternate "
871 		  "screen."
872 	},
873 
874 	{ .name = "automatic-rename",
875 	  .type = OPTIONS_TABLE_FLAG,
876 	  .scope = OPTIONS_TABLE_WINDOW,
877 	  .default_num = 1,
878 	  .text = "Whether windows are automatically renamed."
879 	},
880 
881 	{ .name = "automatic-rename-format",
882 	  .type = OPTIONS_TABLE_STRING,
883 	  .scope = OPTIONS_TABLE_WINDOW,
884 	  .default_str = "#{?pane_in_mode,[tmux],#{pane_current_command}}"
885 			 "#{?pane_dead,[dead],}",
886 	  .text = "Format used to automatically rename windows."
887 	},
888 
889 	{ .name = "clock-mode-colour",
890 	  .type = OPTIONS_TABLE_COLOUR,
891 	  .scope = OPTIONS_TABLE_WINDOW,
892 	  .default_num = 4,
893 	  .text = "Colour of the clock in clock mode."
894 	},
895 
896 	{ .name = "clock-mode-style",
897 	  .type = OPTIONS_TABLE_CHOICE,
898 	  .scope = OPTIONS_TABLE_WINDOW,
899 	  .choices = options_table_clock_mode_style_list,
900 	  .default_num = 1,
901 	  .text = "Time format of the clock in clock mode."
902 	},
903 
904 	{ .name = "copy-mode-match-style",
905 	  .type = OPTIONS_TABLE_STRING,
906 	  .scope = OPTIONS_TABLE_WINDOW,
907 	  .default_str = "bg=cyan,fg=black",
908 	  .flags = OPTIONS_TABLE_IS_STYLE,
909 	  .separator = ",",
910 	  .text = "Style of search matches in copy mode."
911 	},
912 
913 	{ .name = "copy-mode-current-match-style",
914 	  .type = OPTIONS_TABLE_STRING,
915 	  .scope = OPTIONS_TABLE_WINDOW,
916 	  .default_str = "bg=magenta,fg=black",
917 	  .flags = OPTIONS_TABLE_IS_STYLE,
918 	  .separator = ",",
919 	  .text = "Style of the current search match in copy mode."
920 	},
921 
922 	{ .name = "copy-mode-mark-style",
923 	  .type = OPTIONS_TABLE_STRING,
924 	  .scope = OPTIONS_TABLE_WINDOW,
925 	  .default_str = "bg=red,fg=black",
926 	  .flags = OPTIONS_TABLE_IS_STYLE,
927 	  .separator = ",",
928 	  .text = "Style of the marked line in copy mode."
929 	},
930 
931 	{ .name = "fill-character",
932 	  .type = OPTIONS_TABLE_STRING,
933 	  .scope = OPTIONS_TABLE_WINDOW,
934 	  .default_str = "",
935 	  .text = "Character used to fill unused parts of window."
936 	},
937 
938 	{ .name = "main-pane-height",
939 	  .type = OPTIONS_TABLE_STRING,
940 	  .scope = OPTIONS_TABLE_WINDOW,
941 	  .default_str = "24",
942 	  .text = "Height of the main pane in the 'main-horizontal' layout. "
943 		  "This may be a percentage, for example '10%'."
944 	},
945 
946 	{ .name = "main-pane-width",
947 	  .type = OPTIONS_TABLE_STRING,
948 	  .scope = OPTIONS_TABLE_WINDOW,
949 	  .default_str = "80",
950 	  .text = "Width of the main pane in the 'main-vertical' layout. "
951 		  "This may be a percentage, for example '10%'."
952 	},
953 
954 	{ .name = "mode-keys",
955 	  .type = OPTIONS_TABLE_CHOICE,
956 	  .scope = OPTIONS_TABLE_WINDOW,
957 	  .choices = options_table_mode_keys_list,
958 	  .default_num = MODEKEY_EMACS,
959 	  .text = "Key set used in copy mode."
960 	},
961 
962 	{ .name = "mode-style",
963 	  .type = OPTIONS_TABLE_STRING,
964 	  .scope = OPTIONS_TABLE_WINDOW,
965 	  .default_str = "bg=yellow,fg=black",
966 	  .flags = OPTIONS_TABLE_IS_STYLE,
967 	  .separator = ",",
968 	  .text = "Style of indicators and highlighting in modes."
969 	},
970 
971 	{ .name = "monitor-activity",
972 	  .type = OPTIONS_TABLE_FLAG,
973 	  .scope = OPTIONS_TABLE_WINDOW,
974 	  .default_num = 0,
975 	  .text = "Whether an alert is triggered by activity."
976 	},
977 
978 	{ .name = "monitor-bell",
979 	  .type = OPTIONS_TABLE_FLAG,
980 	  .scope = OPTIONS_TABLE_WINDOW,
981 	  .default_num = 1,
982 	  .text = "Whether an alert is triggered by a bell."
983 	},
984 
985 	{ .name = "monitor-silence",
986 	  .type = OPTIONS_TABLE_NUMBER,
987 	  .scope = OPTIONS_TABLE_WINDOW,
988 	  .minimum = 0,
989 	  .maximum = INT_MAX,
990 	  .default_num = 0,
991 	  .text = "Time after which an alert is triggered by silence. "
992 		  "Zero means no alert."
993 
994 	},
995 
996 	{ .name = "other-pane-height",
997 	  .type = OPTIONS_TABLE_STRING,
998 	  .scope = OPTIONS_TABLE_WINDOW,
999 	  .default_str = "0",
1000 	  .text = "Height of the other panes in the 'main-horizontal' layout. "
1001 		  "This may be a percentage, for example '10%'."
1002 	},
1003 
1004 	{ .name = "other-pane-width",
1005 	  .type = OPTIONS_TABLE_STRING,
1006 	  .scope = OPTIONS_TABLE_WINDOW,
1007 	  .default_str = "0",
1008 	  .text = "Height of the other panes in the 'main-vertical' layout. "
1009 		  "This may be a percentage, for example '10%'."
1010 	},
1011 
1012 	{ .name = "pane-active-border-style",
1013 	  .type = OPTIONS_TABLE_STRING,
1014 	  .scope = OPTIONS_TABLE_WINDOW,
1015 	  .default_str = "#{?pane_in_mode,fg=yellow,#{?synchronize-panes,fg=red,fg=green}}",
1016 	  .flags = OPTIONS_TABLE_IS_STYLE,
1017 	  .separator = ",",
1018 	  .text = "Style of the active pane border."
1019 	},
1020 
1021 	{ .name = "pane-base-index",
1022 	  .type = OPTIONS_TABLE_NUMBER,
1023 	  .scope = OPTIONS_TABLE_WINDOW,
1024 	  .minimum = 0,
1025 	  .maximum = USHRT_MAX,
1026 	  .default_num = 0,
1027 	  .text = "Index of the first pane in each window."
1028 	},
1029 
1030 	{ .name = "pane-border-format",
1031 	  .type = OPTIONS_TABLE_STRING,
1032 	  .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1033 	  .default_str = "#{?pane_active,#[reverse],}#{pane_index}#[default] "
1034 			 "\"#{pane_title}\"",
1035 	  .text = "Format of text in the pane status lines."
1036 	},
1037 
1038 	{ .name = "pane-border-indicators",
1039 	  .type = OPTIONS_TABLE_CHOICE,
1040 	  .scope = OPTIONS_TABLE_WINDOW,
1041 	  .choices = options_table_pane_border_indicators_list,
1042 	  .default_num = PANE_BORDER_COLOUR,
1043 	  .text = "Whether to indicate the active pane by colouring border or "
1044 		  "displaying arrow markers."
1045 	},
1046 
1047 	{ .name = "pane-border-lines",
1048 	  .type = OPTIONS_TABLE_CHOICE,
1049 	  .scope = OPTIONS_TABLE_WINDOW,
1050 	  .choices = options_table_pane_border_lines_list,
1051 	  .default_num = PANE_LINES_SINGLE,
1052 	  .text = "Type of characters used to draw pane border lines. Some of "
1053 		  "these are only supported on terminals with UTF-8 support."
1054 	},
1055 
1056 	{ .name = "pane-border-status",
1057 	  .type = OPTIONS_TABLE_CHOICE,
1058 	  .scope = OPTIONS_TABLE_WINDOW,
1059 	  .choices = options_table_pane_status_list,
1060 	  .default_num = PANE_STATUS_OFF,
1061 	  .text = "Position of the pane status lines."
1062 	},
1063 
1064 	{ .name = "pane-border-style",
1065 	  .type = OPTIONS_TABLE_STRING,
1066 	  .scope = OPTIONS_TABLE_WINDOW,
1067 	  .default_str = "default",
1068 	  .flags = OPTIONS_TABLE_IS_STYLE,
1069 	  .separator = ",",
1070 	  .text = "Style of the pane status lines."
1071 	},
1072 
1073 	{ .name = "pane-colours",
1074 	  .type = OPTIONS_TABLE_COLOUR,
1075 	  .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1076 	  .default_str = "",
1077 	  .flags = OPTIONS_TABLE_IS_ARRAY,
1078 	  .text = "The default colour palette for colours zero to 255."
1079 	},
1080 
1081 	{ .name = "popup-style",
1082 	  .type = OPTIONS_TABLE_STRING,
1083 	  .scope = OPTIONS_TABLE_WINDOW,
1084 	  .default_str = "default",
1085 	  .flags = OPTIONS_TABLE_IS_STYLE,
1086 	  .separator = ",",
1087 	  .text = "Default style of popups."
1088 	},
1089 
1090 	{ .name = "popup-border-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 popup borders."
1097 	},
1098 
1099 	{ .name = "popup-border-lines",
1100 	  .type = OPTIONS_TABLE_CHOICE,
1101 	  .scope = OPTIONS_TABLE_WINDOW,
1102 	  .choices = options_table_popup_border_lines_list,
1103 	  .default_num = BOX_LINES_SINGLE,
1104 	  .text = "Type of characters used to draw popup border lines. Some of "
1105 		  "these are only supported on terminals with UTF-8 support."
1106 	},
1107 
1108 	{ .name = "remain-on-exit",
1109 	  .type = OPTIONS_TABLE_CHOICE,
1110 	  .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1111 	  .choices = options_table_remain_on_exit_list,
1112 	  .default_num = 0,
1113 	  .text = "Whether panes should remain ('on') or be automatically "
1114 		  "killed ('off' or 'failed') when the program inside exits."
1115 	},
1116 
1117 	{ .name = "remain-on-exit-format",
1118 	  .type = OPTIONS_TABLE_STRING,
1119 	  .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1120 	  .default_str = "Pane is dead ("
1121 			 "#{?#{!=:#{pane_dead_status},},"
1122 	                 "status #{pane_dead_status},}"
1123 			 "#{?#{!=:#{pane_dead_signal},},"
1124 	                 "signal #{pane_dead_signal},}, "
1125 			 "#{t:pane_dead_time})",
1126 	  .text = "Message shown after the program in a pane has exited, if "
1127 	          "remain-on-exit is enabled."
1128 	},
1129 
1130 	{ .name = "scroll-on-clear",
1131 	  .type = OPTIONS_TABLE_FLAG,
1132 	  .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1133 	  .default_num = 1,
1134 	  .text = "Whether the contents of the screen should be scrolled into"
1135 		  "history when clearing the whole screen."
1136 	},
1137 
1138 	{ .name = "synchronize-panes",
1139 	  .type = OPTIONS_TABLE_FLAG,
1140 	  .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1141 	  .default_num = 0,
1142 	  .text = "Whether typing should be sent to all panes simultaneously."
1143 	},
1144 
1145 	{ .name = "window-active-style",
1146 	  .type = OPTIONS_TABLE_STRING,
1147 	  .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1148 	  .default_str = "default",
1149 	  .flags = OPTIONS_TABLE_IS_STYLE,
1150 	  .separator = ",",
1151 	  .text = "Default style of the active pane."
1152 	},
1153 
1154 	{ .name = "window-size",
1155 	  .type = OPTIONS_TABLE_CHOICE,
1156 	  .scope = OPTIONS_TABLE_WINDOW,
1157 	  .choices = options_table_window_size_list,
1158 	  .default_num = WINDOW_SIZE_LATEST,
1159 	  .text = "How window size is calculated. "
1160 		  "'latest' uses the size of the most recently used client, "
1161 		  "'largest' the largest client, 'smallest' the smallest "
1162 		  "client and 'manual' a size set by the 'resize-window' "
1163 		  "command."
1164 	},
1165 
1166 	{ .name = "window-style",
1167 	  .type = OPTIONS_TABLE_STRING,
1168 	  .scope = OPTIONS_TABLE_WINDOW|OPTIONS_TABLE_PANE,
1169 	  .default_str = "default",
1170 	  .flags = OPTIONS_TABLE_IS_STYLE,
1171 	  .separator = ",",
1172 	  .text = "Default style of panes that are not the active pane."
1173 	},
1174 
1175 	{ .name = "window-status-activity-style",
1176 	  .type = OPTIONS_TABLE_STRING,
1177 	  .scope = OPTIONS_TABLE_WINDOW,
1178 	  .default_str = "reverse",
1179 	  .flags = OPTIONS_TABLE_IS_STYLE,
1180 	  .separator = ",",
1181 	  .text = "Style of windows in the status line with an activity alert."
1182 	},
1183 
1184 	{ .name = "window-status-bell-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 a bell alert."
1191 	},
1192 
1193 	{ .name = "window-status-current-format",
1194 	  .type = OPTIONS_TABLE_STRING,
1195 	  .scope = OPTIONS_TABLE_WINDOW,
1196 	  .default_str = "#I:#W#{?window_flags,#{window_flags}, }",
1197 	  .text = "Format of the current window in the status line."
1198 	},
1199 
1200 	{ .name = "window-status-current-style",
1201 	  .type = OPTIONS_TABLE_STRING,
1202 	  .scope = OPTIONS_TABLE_WINDOW,
1203 	  .default_str = "default",
1204 	  .flags = OPTIONS_TABLE_IS_STYLE,
1205 	  .separator = ",",
1206 	  .text = "Style of the current window in the status line."
1207 	},
1208 
1209 	{ .name = "window-status-format",
1210 	  .type = OPTIONS_TABLE_STRING,
1211 	  .scope = OPTIONS_TABLE_WINDOW,
1212 	  .default_str = "#I:#W#{?window_flags,#{window_flags}, }",
1213 	  .text = "Format of windows in the status line, except the current "
1214 		  "window."
1215 	},
1216 
1217 	{ .name = "window-status-last-style",
1218 	  .type = OPTIONS_TABLE_STRING,
1219 	  .scope = OPTIONS_TABLE_WINDOW,
1220 	  .default_str = "default",
1221 	  .flags = OPTIONS_TABLE_IS_STYLE,
1222 	  .separator = ",",
1223 	  .text = "Style of the last window in the status line."
1224 	},
1225 
1226 	{ .name = "window-status-separator",
1227 	  .type = OPTIONS_TABLE_STRING,
1228 	  .scope = OPTIONS_TABLE_WINDOW,
1229 	  .default_str = " ",
1230 	  .text = "Separator between windows in the status line."
1231 	},
1232 
1233 	{ .name = "window-status-style",
1234 	  .type = OPTIONS_TABLE_STRING,
1235 	  .scope = OPTIONS_TABLE_WINDOW,
1236 	  .default_str = "default",
1237 	  .flags = OPTIONS_TABLE_IS_STYLE,
1238 	  .separator = ",",
1239 	  .text = "Style of windows in the status line, except the current and "
1240 		  "last windows."
1241 	},
1242 
1243 	{ .name = "wrap-search",
1244 	  .type = OPTIONS_TABLE_FLAG,
1245 	  .scope = OPTIONS_TABLE_WINDOW,
1246 	  .default_num = 1,
1247 	  .text = "Whether searching in copy mode should wrap at the top or "
1248 		  "bottom."
1249 	},
1250 
1251 	{ .name = "xterm-keys", /* no longer used */
1252 	  .type = OPTIONS_TABLE_FLAG,
1253 	  .scope = OPTIONS_TABLE_WINDOW,
1254 	  .default_num = 1,
1255 	  .text = "Whether xterm-style function key sequences should be sent. "
1256 		  "This option is no longer used."
1257 	},
1258 
1259 	/* Hook options. */
1260 	OPTIONS_TABLE_HOOK("after-bind-key", ""),
1261 	OPTIONS_TABLE_HOOK("after-capture-pane", ""),
1262 	OPTIONS_TABLE_HOOK("after-copy-mode", ""),
1263 	OPTIONS_TABLE_HOOK("after-display-message", ""),
1264 	OPTIONS_TABLE_HOOK("after-display-panes", ""),
1265 	OPTIONS_TABLE_HOOK("after-kill-pane", ""),
1266 	OPTIONS_TABLE_HOOK("after-list-buffers", ""),
1267 	OPTIONS_TABLE_HOOK("after-list-clients", ""),
1268 	OPTIONS_TABLE_HOOK("after-list-keys", ""),
1269 	OPTIONS_TABLE_HOOK("after-list-panes", ""),
1270 	OPTIONS_TABLE_HOOK("after-list-sessions", ""),
1271 	OPTIONS_TABLE_HOOK("after-list-windows", ""),
1272 	OPTIONS_TABLE_HOOK("after-load-buffer", ""),
1273 	OPTIONS_TABLE_HOOK("after-lock-server", ""),
1274 	OPTIONS_TABLE_HOOK("after-new-session", ""),
1275 	OPTIONS_TABLE_HOOK("after-new-window", ""),
1276 	OPTIONS_TABLE_HOOK("after-paste-buffer", ""),
1277 	OPTIONS_TABLE_HOOK("after-pipe-pane", ""),
1278 	OPTIONS_TABLE_HOOK("after-queue", ""),
1279 	OPTIONS_TABLE_HOOK("after-refresh-client", ""),
1280 	OPTIONS_TABLE_HOOK("after-rename-session", ""),
1281 	OPTIONS_TABLE_HOOK("after-rename-window", ""),
1282 	OPTIONS_TABLE_HOOK("after-resize-pane", ""),
1283 	OPTIONS_TABLE_HOOK("after-resize-window", ""),
1284 	OPTIONS_TABLE_HOOK("after-save-buffer", ""),
1285 	OPTIONS_TABLE_HOOK("after-select-layout", ""),
1286 	OPTIONS_TABLE_HOOK("after-select-pane", ""),
1287 	OPTIONS_TABLE_HOOK("after-select-window", ""),
1288 	OPTIONS_TABLE_HOOK("after-send-keys", ""),
1289 	OPTIONS_TABLE_HOOK("after-set-buffer", ""),
1290 	OPTIONS_TABLE_HOOK("after-set-environment", ""),
1291 	OPTIONS_TABLE_HOOK("after-set-hook", ""),
1292 	OPTIONS_TABLE_HOOK("after-set-option", ""),
1293 	OPTIONS_TABLE_HOOK("after-show-environment", ""),
1294 	OPTIONS_TABLE_HOOK("after-show-messages", ""),
1295 	OPTIONS_TABLE_HOOK("after-show-options", ""),
1296 	OPTIONS_TABLE_HOOK("after-split-window", ""),
1297 	OPTIONS_TABLE_HOOK("after-unbind-key", ""),
1298 	OPTIONS_TABLE_HOOK("alert-activity", ""),
1299 	OPTIONS_TABLE_HOOK("alert-bell", ""),
1300 	OPTIONS_TABLE_HOOK("alert-silence", ""),
1301 	OPTIONS_TABLE_HOOK("client-active", ""),
1302 	OPTIONS_TABLE_HOOK("client-attached", ""),
1303 	OPTIONS_TABLE_HOOK("client-detached", ""),
1304 	OPTIONS_TABLE_HOOK("client-focus-in", ""),
1305 	OPTIONS_TABLE_HOOK("client-focus-out", ""),
1306 	OPTIONS_TABLE_HOOK("client-resized", ""),
1307 	OPTIONS_TABLE_HOOK("client-session-changed", ""),
1308 	OPTIONS_TABLE_PANE_HOOK("pane-died", ""),
1309 	OPTIONS_TABLE_PANE_HOOK("pane-exited", ""),
1310 	OPTIONS_TABLE_PANE_HOOK("pane-focus-in", ""),
1311 	OPTIONS_TABLE_PANE_HOOK("pane-focus-out", ""),
1312 	OPTIONS_TABLE_PANE_HOOK("pane-mode-changed", ""),
1313 	OPTIONS_TABLE_PANE_HOOK("pane-set-clipboard", ""),
1314 	OPTIONS_TABLE_PANE_HOOK("pane-title-changed", ""),
1315 	OPTIONS_TABLE_HOOK("session-closed", ""),
1316 	OPTIONS_TABLE_HOOK("session-created", ""),
1317 	OPTIONS_TABLE_HOOK("session-renamed", ""),
1318 	OPTIONS_TABLE_HOOK("session-window-changed", ""),
1319 	OPTIONS_TABLE_WINDOW_HOOK("window-layout-changed", ""),
1320 	OPTIONS_TABLE_HOOK("window-linked", ""),
1321 	OPTIONS_TABLE_WINDOW_HOOK("window-pane-changed", ""),
1322 	OPTIONS_TABLE_WINDOW_HOOK("window-renamed", ""),
1323 	OPTIONS_TABLE_WINDOW_HOOK("window-resized", ""),
1324 	OPTIONS_TABLE_HOOK("window-unlinked", ""),
1325 
1326 	{ .name = NULL }
1327 };
1328