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