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