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