xref: /netbsd-src/external/bsd/tmux/dist/CHANGES (revision f8cf1a9151c7af1cb0bd8b09c13c66bca599c027)
1CHANGES FROM 3.5 TO 3.5a
2
3* Do not translate BSpace as Unicode with extended keys.
4
5* Fix so that keys with Shift are represented correctly with extended keys.
6
7* Revert to using /bin/sh for #() and run-shell and if-shell; the change to use
8  default-shell only applies now to popups.
9
10* Fix grey colour without a number suffix in styles.
11
12CHANGES FROM 3.4 TO 3.5
13
14* Revamp extended keys support to more closely match xterm and support mode 2
15  as well as mode 1. This is a substantial change to key handling which changes
16  tmux to always request mode 2 from parent terminal, changes to an unambiguous
17  internal representation of keys, and adds an option (extended-keys-format) to
18  control the format similar to the xterm(1) formatOtherKeys resource.
19
20* Clear an overlay (popup or menu) when command prompt is entered.
21
22* Add copy-mode -d flag to scroll a page down if in copy mode already (matching
23  -e).
24
25* Display hyperlinks in copy mode and add copy_cursor_hyperlink format to get
26  the hyperlink under the cursor.
27
28* Add a prefix timeout option.
29
30* Mouse move keys are not useful as key bindings because we do not turn them on
31  unless the application requests them. Ignore them so they do not cause the
32  prefix to be canceled
33
34* Add search_count and search_count_partial formats in copy mode.
35
36* Do not reset mouse pane if clicked on status line,
37
38* Add mirrored versions of the main-horizontal and main-vertical layouts where
39  the main pane is bottom or right instead of top or left.
40
41* Allow REP to work with Unicode characters.
42
43* Fix size calculation of terminators for clipboard escape sequences.
44
45* Treat CRLF as LF in config files where it is easy to do so.
46
47* The Linux console has some bugs with bright colours, so add some workarounds
48  for it.
49
50* If built with systemd, remove some environment variables it uses.
51
52* Adjust the logic when deleting last buffer to better preserve the selection:
53  if selecting the element below the deleted one fails (because as the last
54  one), select the one above it instead.
55
56* Add --enable-jemalloc to build with jemalloc memory allocator (since glibc
57  malloc is so poor).
58
59* Add a way (refresh-client -r) for control mode clients to provide OSC 10 and
60  11 responses to tmux so they can set the default foreground and background
61  colours.
62
63* Add N to search backwards in tree modes.
64
65* Use default-shell for command prompt, #() and popups.
66
67* Revert part of a change intended to improve search performance by skipping
68  parts of lines already searched, but which in fact skipped the ends of lines
69  altogether.
70
71* Add a command-error hook when a command fails.
72
73* Add an option allow-set-title to forbid applications from changing the pane
74  title.
75
76* Correct handling of mouse up events (don't ignore all but the last released
77  button), and always process down event for double click.
78
79* Fix a crash if focusing a pane that is exiting.
80
81* Pick newest session (as documented) when looking for next session for
82  detach-on-destroy.
83
84* Reduce default escape-time to 10 milliseconds.
85
86* Add display-menu -M to always turn mouse on in a menu.
87
88* Look for feature code 21 for DECSLRM and 28 for DECFRA in the device
89  attributes and also accept level 1.
90
91* Fix crash if built with SIXEL and the SIXEL colour register is invalid; also
92  remove SIXEL images before reflow.
93
94* Do not notify window-layout-changed if the window is about to be destroyed.
95
96* Do not consider a selection present if it is empty for the selection_active
97  and selection_present format variables.
98
99* Fix split-window -p.
100
101CHANGES FROM 3.3a TO 3.4
102
103* Add options keep-last and keep-group to destroy-unattached to keep the last
104  session whether in a group.
105
106* Don't allow paste-buffer into dead panes.
107
108* Add -t to source-file.
109
110* Rewrite combined character handling to be more consistent and to support
111  newer Unicode combined characters.
112
113* Add basic support for SIXEL if built with --enable-sixel.
114
115* Add a session, pane and user mouse range types for the status line and add
116  format variables for mouse_status_line and mouse_status_range so they can be
117  associated with different commands in the key bindings.
118
119* Add flag (-o) to next-prompt/previous-prompt to go to OSC 133 command output.
120
121* Add options and flags for menu styles (menu-style, menu-border-style) similar
122  to those existing for popups.
123
124* Add support for marking lines with a shell prompt based on the OSC 133 extension.
125
126* Check for libterminfo for NetBSD.
127
128* Add "us" to styles for underscore colour.
129
130* Add flags (-c and -y) to change the confirm key and default behaviour of
131  confirm-before.
132
133* Use ncurses' new tparm_s function (added in 6.4-20230424) instead of tparm so
134  it does not object to string arguments in c apabilities it doesn't already
135  know. Also ignore errors from tparm if using previous ncurses versions.
136
137* Set default lock command to vlock on Linux if present at build time.
138
139* Discard mouse sequences that have the right form but actually are invalid.
140
141* Add support for spawning panes in separate cgroups with systemd and a
142  configure flag (--disable-cgroups) to turn off.
143
144* Add a format (pane_unseen_changes) to show if there are unseen changes while
145  in a mode.
146
147* Remove old buffer when renaming rather than complaining.
148
149* Add an L modifier like P, W, S to loop over clients.
150
151* Add -f to list-clients like the other list commands.
152
153* Extend display-message to work for control clients.
154
155* Add a flag to display-menu to select the manu item selected when the menu is
156  open.
157
158* Have tmux recognise pasted text wrapped in bracket paste sequences, rather
159  than only forwarding them to the program inside.
160
161* Have client return 1 if process is interrupted to an input pane.
162
163* Query the client terminal for foreground and background colours and if OSC 10
164  or 11 is received but no colour has been set inside tmux, return the colour
165  from the first attached client.
166
167* Add send-keys -K to handle keys directly as if typed (so look up in key
168  table).
169
170* Process escape sequences in show-buffer.
171
172* Add a -l flag to display-message to disable format expansion.
173
174* Add paste-buffer-deleted notification and fix name of paste-buffer-changed.
175
176* Do not attempt to connect to the socket as a client if systemd is active.
177
178* Add scroll-top and scroll-bottom commands to scroll so cursor is at top or
179  bottom.
180
181* Add a -T flag to capture-pane to stop at the last used cell instead of the
182  full width. Restore the previous behaviour by making it default to off unless
183  -J is used.
184
185* Add message-line option to control where message and prompt go.
186
187* Notification when a paste buffer is deleted.
188
189* Add a Nobr terminfo(5) capability to tell tmux the terminal does not use bright
190  colours for bold.
191
192* Change g and G to go to top and bottom in menus.
193
194* Add a third state "all" to allow-passthrough to work even in invisible panes.
195
196* Add support for OSC 8 hyperlinks.
197
198* Store the time lines are scrolled into history and display in copy mode.
199
200* Add a %config-error reply to control mode for configuration file errors since
201  reporting them in view mode is useless.
202
203* A new feature flag (ignorefkeys) to ignore terminfo(5) function key
204  definitions for rxvt.
205
206* Pass through first argument to OSC 52 (which clipboards to set) if the
207  application provides it.
208
209* Expand arguments to send-keys, capture-pane, split-window, join-pane where it
210  makes sense to do so.
211
212* Ignore named buffers when choosing a buffer if one is not specified by the user.
213
214CHANGES FROM 3.3 TO 3.3a
215
216* Do not crash when run-shell produces output from a config file.
217
218* Do not unintentionally turn off all mouse mode when button mode is also
219  present.
220
221CHANGES FROM 3.2a TO 3.3
222
223* Add an ACL list for users connecting to the tmux socket. Users may be
224  forbidden from attaching, forced to attach read-only, or allowed to attach
225  read-write. A new command, server-access, configures the list. File system
226  permissions must still be configured manually.
227
228* Emit window-layout-changed on swap-pane.
229
230* Better error reporting when applying custom layouts.
231
232* Handle ANSI escape sequences in run-shell output.
233
234* Add pane_start_path to match start_command.
235
236* Set PWD so shells have a hint about the real path.
237
238* Do not allow pipe-pane on dead panes.
239
240* Do not report mouse positions (incorrectly) above the maximum of 223 in
241  normal mouse mode.
242
243* Add an option (default off) to control the passthrough escape sequence.
244
245* Support more mouse buttons when the terminal sends them.
246
247* Add a window-resized hook which is fired when the window is actually resized
248  which may be later than the client resize.
249
250* Add next_session_id format with the next session ID.
251
252* Add formats for client and server UID and user.
253
254* Add argument to refresh-client -l to forward clipboard to a pane.
255
256* Add remain-on-exit-format to set text shown when pane is dead.
257
258* With split-window -f use percentages of window size not pane size.
259
260* Add an option (fill-character) to set the character used for unused areas of
261  a client.
262
263* Add an option (scroll-on-clear) to control if tmux scrolls into history on
264  clear.
265
266* Add a capability for OSC 7 and use it similarly to how the title is set (and
267  controlled by the same set-titles option).
268
269* Add support for systemd socket activation (where systemd creates the Unix
270  domain socket for tmux rather than tmux creating it). Build with
271  --enable-systemd.
272
273* Add an option (pane-border-indicators) to select how the active pane is shown
274  on the pane border (colour, arrows or both).
275
276* Support underscore styles with capture-pane -e.
277
278* Make pane-border-format a pane option rather than window.
279
280* Respond to OSC 4 queries
281
282* Fix g/G keys in modes to do the same thing as copy mode (and vi).
283
284* Bump the time terminals have to respond to device attributes queries to three
285  seconds.
286
287* If automatic-rename is off, allow the rename escape sequence to set an empty
288  name.
289
290* Trim menu item text more intelligently.
291
292* Add cursor-style and cursor-colour options to set the default cursor style
293  and colour.
294
295* Accept some useful and non-conflicting emacs keys in vi normal mode at the
296  command prompt.
297
298* Add a format modifier (c) to force a colour to RGB.
299
300* Add -s and -S to display-popup to set styles, -b to set lines and -T to set
301  popup title. New popup-border-lines, popup-border-style and popup-style
302  options set the defaults.
303
304* Add -e flag to set an environment variable for a popup.
305
306* Make send-keys without arguments send the key it is bound to (if bound to a
307  key).
308
309* Try to leave terminal cursor at the right position even when tmux is drawing
310  its own cursor or selection (such as at the command prompt and in choose
311  mode) for people using screen readers and similar which can make use of it.
312
313* Change so that {} is converted to tmux commands immediately when parsed. This
314  means it must contain valid tmux commands. For commands which expand %% and
315  %%%, this now only happens within string arguments. Use of nested aliases
316  inside {} is now forbidden. Processing of commands given in quotes remains
317  the same.
318
319* Disable evports on SunOS since they are broken.
320
321* Do not expand the file given with tmux -f so it can contain :s.
322
323* Bump FORMAT_LOOP_LIMIT and add a log message when hit.
324
325* Add a terminal feature for the mouse (since FreeBSD termcap does not have kmous).
326
327* Forbid empty session names.
328
329* Improve error reporting when the tmux /tmp directory cannot be created or
330  used.
331
332* Give #() commands a one second grace period where the output is empty before
333  telling the user they aren't doing anything ("not ready").
334
335* When building, pick default-terminal from the first of tmux-256color, tmux,
336  screen-256color, screen that is available on the build system (--with-TERM
337  can override).
338
339* Do not close popups on resize, instead adjust them to fit.
340
341* Add a client-active hook.
342
343* Make window-linked and window-unlinked window options.
344
345* Do not configure on macOS without the user making a choice about utf8proc
346  (either --enable-utf8proc or --disable-utf8proc).
347
348* Do not freeze output in panes when a popup is open, let them continue to
349  redraw.
350
351* Add pipe variants of the line copy commands.
352
353* Change copy-line and copy-end-of-line not to cancel and add -and-cancel
354  variants, like the other copy commands.
355
356* Support the OSC palette-setting sequences in popups.
357
358* Add a pane-colours array option to specify the defaults palette.
359
360* Add support for Unicode zero-width joiner.
361
362* Make newline a style delimiter as well so they can cross multiple lines for
363  readability in configuration files.
364
365* Change focus to be driven by events rather than scanning panes so the
366  ordering of in and out is consistent.
367
368* Add display-popup -B to open a popup without a border.
369
370* Add a menu for popups that can be opened with button three outside the popup
371  or on the left or top border. Resizing now only works on the right and bottom
372  borders or when using Meta. The menu allows a popup to be closed, expanded to
373  the full size of the client, centered in the client or changed into a pane.
374
375* Make command-prompt and confirm-before block by default (like run-shell). A
376  new -b flags runs them in the background as before. Also set return code for
377  confirm-before.
378
379* Change cursor style handling so tmux understands which sequences contain
380  blinking and sets the flag appropriately, means that it works whether cnorm
381  disables blinking or not. This now matches xterm's behaviour.
382
383* More accurate vi(1) word navigation in copy mode and on the status line. This
384  changes the meaning of the word-separators option: setting it to the empty
385  string is equivalent to the previous behavior.
386
387* Add -F for command-prompt and use it to fix "Rename" on the window menu.
388
389* Add different command histories for different types of prompts ("command",
390  "search" etc).
391
392CHANGES FROM 3.2 TO 3.2a
393
394* Add an "always" value for the "extended-keys" option; if set then tmux will
395  forward extended keys to applications even if they do not request them.
396
397* Add a "mouse" terminal feature so tmux can enable the mouse on terminals
398  where it is known to be supported even if terminfo(5) says otherwise.
399
400* Do not expand the filename given to -f so it can contain colons.
401
402* Fixes for problems with extended keys and modifiers, scroll region,
403  source-file, crosscompiling, format modifiers and other minor issues.
404
405CHANGES FROM 3.1c TO 3.2
406
407* Add a flag to disable keys to close a message.
408
409* Permit shortcut keys in buffer, client, tree modes to be configured with a
410  format (-K flag to choose-buffer, choose-client, choose-tree).
411
412* Add a current_file format for the config file being parsed.
413
414* When display-message used in config file, show the message after the config
415  file finishes.
416
417* Add client-detached notification in control mode.
418
419* Improve performance of format evaluation.
420
421* Make jump command support UTF-8 in copy mode.
422
423* Support X11 colour names and other colour formats for OSC 10 and 11.
424
425* Add "pipe" variants of "copy-pipe" commands which do not copy.
426
427* Include "focused" in client flags.
428
429* Send Unicode directional isolate characters around horizontal pane borders if
430  the terminal supports UTF-8 and an extension terminfo(5) capability "Bidi" is
431  present.
432
433* Add a -S flag to new-window to make it select the existing window if one
434  with the given name already exists rather than failing with an error.
435
436* Add a format modifier to check if a window or session name exists (N/w or
437  N/s).
438
439* Add compat clock_gettime for older macOS.
440
441* Add a no-detached choice to detach-on-destroy which detaches only if there
442  are no other detached sessions to switch to.
443
444* Add rectangle-on and rectangle-off copy mode commands.
445
446* Change so that window_flags escapes # automatically. A new format
447  window_raw_flags contains the old unescaped version.
448
449* Add -N flag to never start server even if command would normally do so.
450
451* With incremental search, start empty and only repeat the previous search if
452  the user tries to search again with an empty prompt.
453
454* Add a value for remain-on-exit that only keeps the pane if the program
455  failed.
456
457* Add a -C flag to run-shell to use a tmux command rather than a shell command.
458
459* Do not list user options with show-hooks.
460
461* Remove current match indicator in copy mode which can't work anymore since we
462  only search the visible region.
463
464* Make synchronize-panes a pane option and add -U flag to set-option to unset
465  an option on all panes.
466
467* Make replacement of ##s consistent when drawing formats, whether followed by
468  [ or not. Add a flag (e) to the q: format modifier to double up #s.
469
470* Add -N flag to display-panes to ignore keys.
471
472* Change how escaping is processed for formats so that ## and # can be used in
473  styles.
474
475* Add a 'w' format modifier for string width.
476
477* Add support for Haiku.
478
479* Expand menu and popup -x and -y as formats.
480
481* Add numeric comparisons for formats.
482
483* Fire focus events even when the pane is in a mode.
484
485* Add -O flag to display-menu to not automatically close when all mouse buttons
486  are released.
487
488* Allow fnmatch(3) wildcards in update-environment.
489
490* Disable nested job expansion so that the result of #() is not expanded again.
491
492* Use the setal capability as well as (tmux's) Setulc.
493
494* Add -q flag to unbind-key to hide errors.
495
496* Allow -N without a command to change or add a note to an existing key.
497
498* Add a -w flag to set- and load-buffer to send to clipboard using OSC 52.
499
500* Add -F to set-environment and source-file.
501
502* Allow colour to be spelt as color in various places.
503
504* Add n: modifier to get length of a format.
505
506* Respond to OSC colour requests if a colour is available.
507
508* Add a -d option to display-message to set delay.
509
510* Add a way for control mode clients to subscribe to a format and be notified
511  of changes rather than having to poll.
512
513* Add some formats for search in copy mode (search_present, search_match).
514
515* Do not wait on shutdown for commands started with run -b.
516
517* Add -b flags to insert a window before (like the existing -a for after) to
518  break-pane, move-window, new-window.
519
520* Make paste -p the default for ].
521
522* Add support for pausing a pane when the output buffered for a control mode
523  client gets too far behind. The pause-after flag with a time is set on the
524  pane with refresh-client -f and a paused pane may be resumed with
525  refresh-client -A.
526
527* Allow strings in configuration files to span multiple lines - newlines and
528  any leading whitespace are removed, as well as any following comments that
529  couldn't be part of a format. This allows long formats or other strings to be
530  annotated and indented.
531
532* Instead of using a custom parse function to process {} in configuration
533  files, treat as a set of statements the same as outside {} and convert back
534  to a string as the last step. This means the rules are consistent inside and
535  outside {}, %if and friends work at the right time, and the final result
536  isn't littered with unnecessary newlines.
537
538* Add support for extended keys - both xterm(1)'s CSI 27 ~ sequence and the
539  libtickit CSI u sequence are accepted; only the latter is output. tmux will
540  only attempt to use these if the extended-keys option is on and it can detect
541  that the terminal outside supports them (or is told it does with the
542  "extkeys" terminal feature).
543
544* Add an option to set the pane border lines style from a choice of single
545  lines (ACS or UTF-8), double or heavy (UTF-8), simple (plain ASCII) or number
546  (the pane numbers). Lines that won't work on a non-UTF-8 terminal are
547  translated back into ACS when they are output.
548
549* Make focus events update the latest client (like a key press).
550
551* Store UTF-8 characters differently to reduce memory use.
552
553* Fix break-pane -n when only one pane in the window.
554
555* Instead of sending all data to control mode clients as fast as possible, add
556  a limit of how much data will be sent to the client and try to use it for
557  panes with some degree of fairness.
558
559* Add an active-pane client flag (set with attach-session -f, new-session -f
560  or refresh-client -f). This allows a client to have an independent active
561  pane for interactive use (the window client pane is still used for many
562  things however).
563
564* Add a mark to copy mode, this is set with the set-mark command (bound to X)
565  and appears with the entire line shown using copy-mode-mark-style and the
566  marked character in reverse. The jump-to-mark command (bound to M-x) swaps
567  the mark and the cursor positions.
568
569* Add a -D flag to make the tmux server run in the foreground and not as a
570  daemon.
571
572* Do not loop forever in copy mode when search finds an empty match.
573
574* Fix the next-matching-bracket logic when using vi(1) keys.
575
576* Add a customize mode where options may be browsed and changed, includes
577  adding a brief description of each option. Bound to C-b C by default.
578
579* Change message log (C-b ~) so there is one for the server rather than one per
580  client and it remains after detach, and make it useful by logging every
581  command.
582
583* Add M-+ and M-- to tree mode to expand and collapse all.
584
585* Change the existing client flags for control mode to apply for any client,
586  use the same mechanism for the read-only flag and add an ignore-size flag.
587
588  refresh-client -F has become -f (-F stays for backwards compatibility) and
589  attach-session and switch-client now have -f flags also. A new format
590  client_flags lists the flags and is shown by list-clients by default.
591
592  This separates the read-only flag from "ignore size" behaviour (new
593  ignore-size) flag - both behaviours are useful in different circumstances.
594
595  attach -r and switchc -r remain and set or toggle both flags together.
596
597* Store and restore cursor position when copy mode is resized.
598
599* Export TERM_PROGRAM and TERM_PROGRAM_VERSION like various other terminals.
600
601* Add formats for after hook command arguments: hook_arguments with all the
602  arguments together; hook_argument_0, hook_argument_1 and so on with
603  individual arguments; hook_flag_X if flag -X is present; hook_flag_X_0,
604  hook_flag_X_1 and so on if -X appears multiple times.
605
606* Try to search the entire history first for up to 200 ms so a search count can
607  be shown. If it takes too long, search the visible text only.
608
609* Use VIS_CSTYLE for paste buffers also (show \012 as \n).
610
611* Change default formats for tree mode, client mode and buffer mode to be more
612  compact and remove some clutter.
613
614* Add a key (e) in buffer mode to open the buffer in an editor. The buffer
615  contents is updated when the editor exits.
616
617* Add -e flag for new-session to set environment variables, like the same flag
618  for new-window.
619
620* Improve search match marking in copy mode. Two new options
621  copy-mode-match-style and copy-mode-current-match-style to set the style for
622  matches and for the current match respectively. Also a change so that if a
623  copy key is pressed with no selection, the current match (if any) is copied.
624
625* Sanitize session names like window names instead of forbidding invalid ones.
626
627* Check if the clear terminfo(5) capability starts with CSI and if so then
628  assume the terminal is VT100-like, rather than relying on the XT capability.
629
630* Improve command prompt tab completion and add menus both for strings and -t
631  and -s (when used without a trailing space). command-prompt has additional
632  flags for only completing a window (-W) and a target (-T), allowing C-b ' to
633  only show windows and C-b . only targets.
634
635* Change all the style options to string options so they can support formats.
636  Change pane-active-border-style to use this to change the border colour when
637  in a mode or with synchronize-panes on. This also implies a few minor changes
638  to existing behaviour:
639
640  - set-option -a with a style option automatically inserts a comma between the
641    old value and appended text.
642
643  - OSC 10 and 11 no longer set the window-style option, instead they store the
644    colour internally in the pane data and it is used as the default when the
645    option is evaluated.
646
647  - status-fg and -bg now override status-style instead of the option values
648    being changed.
649
650* Add extension terminfo(5) capabilities for margins and focus reporting.
651
652* Try $XDG_CONFIG_HOME/tmux/tmux.conf as well as ~/.config/tmux/tmux.conf for
653  configuration file (the search paths are in TMUX_CONF in Makefile.am).
654
655* Remove the DSR 1337 iTerm2 extension and replace by the extended device
656  attributes sequence (CSI > q) supported by more terminals.
657
658* Add a -s flag to copy-mode to specify a different pane for the source
659  content. This means it is possible to view two places in a pane's history at
660  the same time in different panes, or view the history while still using the
661  pane. Pressing r refreshes the content from the source pane.
662
663* Add an argument to list-commands to show only a single command.
664
665* Change copy mode to make copy of the pane history so it does not need to
666  freeze the pane.
667
668* Restore pane_current_path format from portable tmux on OpenBSD.
669
670* Wait until the initial command sequence is done before sending a device
671  attributes request and other bits that prompt a reply from the terminal. This
672  means that stray replies are not left on the terminal if the command has
673  attached and then immediately detached and tmux will not be around to receive
674  them.
675
676* Add a -f filter argument to the list commands like choose-tree.
677
678* Move specific hooks for panes to pane options and windows for window options
679  rather than all hooks being session options. These hooks are now window options:
680
681  window-layout-changed
682  window-linked
683  window-pane-changed
684  window-renamed
685  window-unlinked
686
687  And these are now pane options:
688
689  pane-died
690  pane-exited
691  pane-focus-in
692  pane-focus-out
693  pane-mode-changed
694  pane-set-clipboard
695
696  Any existing configurations using these hooks on a session rather than
697  globally (that is, set-hook or set-option without -g) may need to be changed.
698
699* Show signal names when a process exits with remain-on-exit on platforms which
700  have a way to get them.
701
702* Start menu with top item selected if no mouse and use mode-style for the
703  selected item.
704
705* Add a copy-command option and change copy-pipe and friends to pipe to it if
706  used without arguments, allows all the default copy key bindings to be
707  changed to pipe with one option rather than needing to change each key
708  binding individually.
709
710* Tidy up the terminal detection and feature code and add named sets of
711  terminal features, each of which are defined in one place and map to a
712  builtin set of terminfo(5) capabilities. Features can be specified based on
713  TERM with a new terminal-features option or with the -T flag when running
714  tmux. tmux will also detect a few common terminals from the DA and DSR
715  responses.
716
717  This is intended to make it easier to configure tmux's use of terminfo(5)
718  even in the presence of outdated ncurses(3) or terminfo(5) databases or for
719  features which do not yet have a terminfo(5) entry. Instead of having to grok
720  terminfo(5) capability names and what they should be set to in the
721  terminal-overrides option, the user can hopefully just give tmux a feature
722  name and let it do the right thing.
723
724  The terminal-overrides option remains both for backwards compatibility and to
725  allow tweaks of individual capabilities.
726
727* Support mintty's application escape sequence (means tmux doesn't have to
728  delay to wait for Escape, so no need to reduce escape-time when using
729  mintty).
730
731* Change so main-pane-width and height can be given as a percentage.
732
733* Support for the iTerm2 synchronized updates feature (allows the terminal to
734  avoid unnecessary drawing while output is still in progress).
735
736* Make the mouse_word and mouse_line formats work in copy mode and enable the
737  default pane menu in copy mode.
738
739* Add a -T flag to resize-pane to trim lines below the cursor, moving lines out
740  of the history.
741
742* Add a way to mark environment variables as "hidden" so they can be used by
743  tmux (for example in formats) but are not set in the environment for new
744  panes. set-environment and show-environment have a new -h flag and there is a
745  new %hidden statement for the configuration file.
746
747* Change default position for display-menu -x and -y to centre rather than top
748  left.
749
750* Add support for per-client transient popups, similar to menus but which are
751  connected to an external command (like a pane). These are created with new
752  command display-popup.
753
754* Change double and triple click bindings so that only one is fired (previously
755  double click was fired on the way to triple click). Also add default double
756  and triple click bindings to copy the word or line under the cursor and
757  change the existing bindings in copy mode to do the same.
758
759* Add a default binding for button 2 to paste.
760
761* Add -d flag to run-shell to delay before running the command and allow it to
762  be used without a command so it just delays.
763
764* Add C-g to cancel command prompt with vi keys as well as emacs, and q in
765  command mode.
766
767* When the server socket is given with -S, create it with umask 177 instead of
768  117 (because it may not be in a safe directory like the default directory in
769  /tmp).
770
771* Add a copy-mode -H flag to hide the position marker in the top right.
772
773* Add number operators for formats (+, -, *, / and m),
774
775CHANGED FROM 3.1b TO 3.1c
776
777* Do not write after the end of the array and overwrite the stack when
778  colon-separated SGR sequences contain empty arguments.
779
780CHANGES FROM 3.1a TO 3.1b
781
782* Fix build on systems without sys/queue.h.
783
784* Fix crash when allow-rename is on and an empty name is set.
785
786CHANGES FROM 3.1 TO 3.1a
787
788* Do not close stdout prematurely in control mode since it is needed to print
789  exit messages. Prevents hanging when detaching with iTerm2.
790
791CHANGES FROM 3.0a TO 3.1
792
793* Only search the visible part of the history when marking (highlighting)
794  search terms. This is much faster than searching the whole history and solves
795  problems with large histories. The count of matches shown is now the visible
796  matches rather than all matches.
797
798* Search using regular expressions in copy mode. search-forward and
799  search-backward use regular expressions by default; the incremental versions
800  do not.
801
802* Turn off mouse mode 1003 as well as the rest when exiting.
803
804* Add selection_active format for when the selection is present but not moving
805  with the cursor.
806
807* Fix dragging with modifier keys, so binding keys such as C-MouseDrag1Pane and
808  C-MouseDragEnd1Pane now work.
809
810* Add -a to list-keys to also list keys without notes with -N.
811
812* Do not jump to next word end if already on a word end when selecting a word;
813  fixes select-word with single character words and vi(1) keys.
814
815* Fix top and bottom pane calculation with pane border status enabled.
816
817* Add support for adding a note to a key binding (with bind-key -N) and use
818  this to add descriptions to the default key bindings. A new -N flag to
819  list-keys shows key bindings with notes. Change the default ? binding to use
820  this to show a readable summary of keys. Also extend command-prompt to return
821  the name of the key pressed and add a default binding (/) to show the note
822  for the next key pressed.
823
824* Add support for the iTerm2 DSR 1337 sequence to get the terminal version.
825
826* Treat plausible but invalid keys (like C-BSpace) as literal like any other
827  unrecognised string passed to send-keys.
828
829* Detect iTerm2 and enable use of DECSLRM (much faster with horizontally split
830  windows).
831
832* Add -Z to default switch-client command in tree mode.
833
834* Add ~ to quoted characters for %%%.
835
836* Document client exit messages in the manual page.
837
838* Do not let read-only clients limit the size, unless all clients are
839  read-only.
840
841* Add a number of new formats to inspect what sessions and clients a window is
842  present or active in.
843
844* Change file reading and writing to go through the client if necessary. This
845  fixes commands like "tmux loadb /dev/fd/X". Also modify source-file to
846  support "-" for standard input, like load-buffer and save-buffer.
847
848* Add ~/.config/tmux/tmux.conf to the default search path for configuration
849  files.
850
851* Bump the escape sequence timeout to five seconds to allow for longer
852  legitimate sequences.
853
854* Make a best effort to set xpixel and ypixel for each pane and add formats for
855  them.
856
857* Add push-default to status-left and status-right in status-format[0].
858
859* Do not clear search marks on cursor movement with vi(1) keys.
860
861* Add p format modifier for padding to width and allow multiple substitutions
862  in a single format.
863
864* Add -f for full size to join-pane (like split-window).
865
866* Do not use bright when emulating 256 colours on an 8 colour terminal because
867  it is also bold on some terminals.
868
869* Make select-pane -P set window-active-style also to match previous behaviour.
870
871* Do not truncate list-keys output.
872
873* Turn automatic-rename back on if the \033k rename escape sequence is used
874  with an empty name.
875
876* Add support for percentage sizes for resize-pane ("-x 10%"). Also change
877  split-window and join-pane -l to accept similar percentages and deprecate the
878  -p flag.
879
880* Add -F flag to send-keys to expand formats in search-backward and forward
881  copy mode commands and copy_cursor_word and copy_cursor_line formats for word
882  and line at cursor in copy mode. Use for default # and * binding with vi(1)
883  keys.
884
885* Add formats for word and line at cursor position in copy mode.
886
887* Add formats for cursor and selection position in copy mode.
888
889* Support all the forms of RGB colour strings in OSC sequences rather than
890  requiring two digits.
891
892* Limit lazy resize to panes in attached sessions only.
893
894* Add an option to set the key sent by backspace for those whose system uses ^H
895  rather than ^?.
896
897* Change new-session -A without a session name (that is, no -s option also) to
898  attach to the best existing session like attach-session rather than a new
899  one.
900
901* Add a "latest" window-size option which tries to size windows based on the
902  most recently used client. This is now the default.
903
904* Add simple support for OSC 7 (result is available in the pane_path format).
905
906* Add push-default and pop-default for styles which change the colours and
907  attributes used for #[default]. These are used in status-format to restore
908  the behaviour of window-status-style being the default for
909  window-status-format.
910
911* Add window_marked_flag.
912
913* Add cursor-down-and-cancel in copy mode.
914
915* Default to previous search string for search-forward and search-backward.
916
917* Add -Z flag to rotate-window, select-pane, swap-pane, switch-client to
918  preserve zoomed state.
919
920* Add -N to capture-pane to preserve trailing spaces.
921
922* Add reverse sorting in tree, client and buffer modes.
923
924CHANGES FROM 3.0 TO 3.0a
925
926* Do not require REG_STARTEND.
927
928* Respawn panes or windows correctly if default-command is set.
929
930* Add missing option for after-kill-pane hook.
931
932* Fix for crash with a format variable that doesn't exist.
933
934* Do not truncate list-keys output on some platforms.
935
936* Do not crash when restoring a layout with only one pane.
937
938CHANGES FROM 2.9 TO 3.0
939
940* Workaround invalid layout strings generated by older tmux versions and add
941  some additional sanity checks
942
943* xterm 348 now disables margins when resized, so send DECLRMM again after
944  resize.
945
946* Add support for the SD (scroll down) escape sequence.
947
948* Expand arguments to C and s format modifiers to match the m modifier.
949
950* Add support for underscore colours (Setulc capability must be added with
951  terminal-overrides as described in tmux(1)).
952
953* Add a "fill" style attribute for the fill colour of the drawing area (where
954  appropriate).
955
956* New -H flag to send-keys to send literal keys.
957
958* Format variables for pane mouse modes (mouse_utf8_flag and mouse_sgr_flag)
959  and for origin mode (origin_flag).
960
961* Add -F to refresh-client for flags for control mode clients, only one flag
962  (no-output) supported at the moment.
963
964* Add a few vi(1) keys for menus.
965
966* Add pane options, set with set-option -p and displayed with show-options -p.
967  Pane options inherit from window options (so every pane option is also
968  a window option). The pane style is now configured by setting window-style
969  and window-active-style in the pane options; select-pane -P and -g now change
970  the option but are no longer documented.
971
972* Do not document set-window-option and show-window-options. set-option -w and
973  show-options -w should be used instead.
974
975* Add a -A flag to show-options to show parent options as well (they are marked
976  with a *).
977
978* Resize panes lazily - do not resize unless they are in an attached, active
979  window.
980
981* Add regular expression support for the format search, match and substitute
982  modifiers and make them able to ignore case. find-window now accepts -r to
983  use regular expressions.
984
985* Do not use $TMUX to find the session because for windows in multiple sessions
986  it is wrong as often as it is right, and for windows in one session it is
987  pointless. Instead use TMUX_PANE if it is present.
988
989* Do not always resize the window back to its original size after applying a
990  layout, keep it at the layout size until it must be resized (for example when
991  attached and window-size is not manual).
992
993* Add new-session -X and attach-session -x to send SIGHUP to parent when
994  detaching (like detach-client -P).
995
996* Support for octal escapes in strings (such as \007) and improve list-keys
997  output so it parses correctly if copied into a configuration file.
998
999* INCOMPATIBLE: Add a new {} syntax to the configuration file. This is a string
1000  similar to single quotes but also includes newlines and allows commands that
1001  take other commands as string arguments to be expressed more clearly and
1002  without additional escaping.
1003
1004  A literal { and } or a string containing { or } must now be escaped or
1005  quoted, for example '{' and '}' instead of { or }, or 'X#{foo}' instead of
1006  X#{foo}.
1007
1008* New <, >, <= and >= comparison operators for formats.
1009
1010* Improve escaping of special characters in list-keys output.
1011
1012* INCOMPATIBLE: tmux's configuration parsing has changed to use yacc(1). There
1013  is one incompatible change: a \ on its own must be escaped or quoted as
1014  either \\ or '\' (the latter works on older tmux versions).
1015
1016  Entirely the same parser is now used for parsing the configuration file
1017  and for string commands. This means that constructs previously only
1018  available in .tmux.conf, such as %if, can now be used in string commands
1019  (for example, those given to if-shell - not commands invoked from the
1020  shell, they are still parsed by the shell itself).
1021
1022* Add support for the overline attribute (SGR 53). The Smol capability is
1023  needed in terminal-overrides.
1024
1025* Add the ability to create simple menus. Introduces new command
1026  display-menu. Default menus are bound to MouseDown3 on the status line;
1027  MouseDown3 or M-MouseDown3 on panes; MouseDown3 in tree, client and
1028  buffer modes; and C-b < and >.
1029
1030* Allow panes to be empty (no command). They can be created either by piping to
1031  split-window -I, or by passing an empty command ('') to split-window. Output
1032  can be sent to an existing empty window with display-message -I.
1033
1034* Add keys to jump between matching brackets (emacs C-M-f and C-M-b, vi %).
1035
1036* Add a -e flag to new-window, split-window, respawn-window, respawn-pane to
1037  pass environment variables into the newly created process.
1038
1039* Hooks are now stored in the options tree as array options, allowing them to
1040  have multiple separate commands. set-hook and show-hooks remain but
1041  set-option and show-options can now also be used (show-options will only show
1042  hooks if given the -H flag). Hooks with multiple commands are run in index
1043  order.
1044
1045* Automatically scroll if dragging to create a selection with the mouse and the
1046  cursor reaches the top or bottom line.
1047
1048* Add -no-clear variants of copy-selection and copy-pipe which do not clear the
1049  selection after copying. Make copy-pipe clear the selection by default to be
1050  consistent with copy-selection.
1051
1052* Add an argument to copy commands to set the prefix for the buffer name, this
1053  (for example) allows buffers for different sessions to be named separately.
1054
1055* Update session activity on focus event.
1056
1057* Pass target from source-file into the config file parser so formats in %if
1058  and %endif have access to more useful variables.
1059
1060* Add the ability to infer an option type (server, session, window) from its
1061  name to show-options (it was already present in set-option).
1062
1063CHANGES FROM 2.9 TO 2.9a
1064
1065* Fix bugs in select-pane and the main-horizontal and main-vertical layouts.
1066
1067CHANGES FROM 2.8 TO 2.9
1068
1069* Attempt to preserve horizontal cursor position as well as vertical with
1070  reflow.
1071
1072* Rewrite main-vertical and horizontal and change layouts to better handle the
1073  case where all panes won't fit into the window size, reduce problems with
1074  pane border status lines and fix other bugs mostly found by Thomas Sattler.
1075
1076* Add format variables for the default formats in the various modes
1077  (tree_mode_format and so on) and add a -a flag to display-message to list
1078  variables with values.
1079
1080* Add a -v flag to display-message to show verbose messages as the format is
1081  parsed, this allows formats to be debugged
1082
1083* Add support for HPA (\033[`).
1084
1085* Add support for origin mode (\033[?6h).
1086
1087* No longer clear history on RIS.
1088
1089* Extend the #[] style syntax and use that together with previous format
1090  changes to allow the status line to be entirely configured with a single
1091  option.
1092
1093  Now that it is possible to configure their content, enable the existing code
1094  that lets the status line be multiple lines in height. The status option can
1095  now take a value of 2, 3, 4 or 5 (as well as the previous on or off) to
1096  configure more than one line. The new status-format array option configures
1097  the format of each line, the default just references the existing status-*
1098  options, although some of the more obscure status options may be eliminated
1099  in time.
1100
1101  Additions to the #[] syntax are: "align" to specify alignment (left, centre,
1102  right), "list" for the window list and "range" to configure ranges of text
1103  for the mouse bindings.
1104
1105  The "align" keyword can also be used to specify alignment of entries in tree
1106  mode and the pane status lines.
1107
1108* Add E: and T: format modifiers to expand a format twice (useful to expand the
1109  value of an option).
1110
1111* The individual -fg, -bg and -attr options have been removed; they
1112  were superseded by -style options in tmux 1.9.
1113
1114* Allow more than one mode to be opened in a pane. Modes are kept on a stack
1115  and retrieved if the same mode is entered again. Exiting the active mode goes
1116  back to the previous one.
1117
1118* When showing command output in copy mode, call it view mode instead (affects
1119  pane_mode format).
1120
1121* Add -b to display-panes like run-shell.
1122
1123* Handle UTF-8 in word-separators option.
1124
1125* New "terminal" colour allowing options to use the terminal default colour
1126  rather than inheriting the default from a parent option.
1127
1128* Do not move the cursor in copy mode when the mouse wheel is used.
1129
1130* Use the same working directory rules for jobs as new windows rather than
1131  always starting in the user's home.
1132
1133* Allow panes to be one line or column in size.
1134
1135* Go to last line when goto-line number is out of range in copy mode.
1136
1137* Yank previously cut text if any with C-y in the command prompt, only use the
1138  buffer if no text has been cut.
1139
1140* Add q: format modifier to quote shell special characters.
1141
1142* Add StatusLeft and StatusRight mouse locations (keys such as
1143  MouseDown1StatusLeft) for the status-left and status-right areas of the
1144  status line.
1145
1146* Add -Z to find-window.
1147
1148* Support for windows larger than the client. This adds two new options,
1149  window-size and default-size, and a new command, resize-window. The
1150  force-width and force-height options and the session_width and session_height
1151  formats have been removed.
1152
1153  The new window-size option tells tmux how to work out the size of windows:
1154  largest means it picks the size of the largest session, smallest the smallest
1155  session (similar to the old behaviour) and manual means that it does not
1156  automatically resize windows. aggressive-resize modifies the choice of
1157  session for largest and smallest as it did before.
1158
1159  If a window is in a session attached to a client that is too small, only part
1160  of the window is shown. tmux attempts to keep the cursor visible, so the part
1161  of the window displayed is changed as the cursor moves (with a small delay,
1162  to try and avoid excess redrawing when applications redraw status lines or
1163  similar that are not currently visible).
1164
1165  Drawing windows which are larger than the client is not as efficient as those
1166  which fit, particularly when the cursor moves, so it is recommended to avoid
1167  using this on slow machines or networks (set window-size to smallest or
1168  manual).
1169
1170  The resize-window command can be used to resize a window manually. If it is
1171  used, the window-size option is automatically set to manual for the window
1172  (undo this with "setw -u window-size"). resize-window works in a similar way
1173  to resize-pane (-U -D -L -R -x -y flags) but also has -a and -A flags. -a
1174  sets the window to the size of the smallest client (what it would be if
1175  window-size was smallest) and -A the largest.
1176
1177  For the same behaviour as force-width or force-height, use resize-window -x
1178  or -y.
1179
1180  If the global window-size option is set to manual, the default-size option is
1181  used for new windows. If -x or -y is used with new-session, that sets the
1182  default-size option for the new session.
1183
1184  The maximum size of a window is 10000x10000. But expect applications to
1185  complain and higher memory use if making a window that big. The minimum size
1186  is the size required for the current layout including borders.
1187
1188  The refresh-client command can be used to pan around a window, -U -D -L -R
1189  moves up, down, left or right and -c returns to automatic cursor
1190  tracking. The position is reset when the current window is changed.
1191
1192CHANGES FROM 2.7 TO 2.8
1193
1194* Make display-panes block the client until a pane is chosen or it
1195  times out.
1196
1197* Clear history on RIS like most other terminals do.
1198
1199* Add an "Any" key to run a command if a key is pressed that is not
1200  bound in the current key table.
1201
1202* Expand formats in load-buffer and save-buffer.
1203
1204* Add a rectangle_toggle format.
1205
1206* Add set-hook -R to run a hook immediately.
1207
1208* Add README.ja.
1209
1210* Add pane focus hooks.
1211
1212* Allow any punctuation as separator for s/x/y not only /.
1213
1214* Improve resizing with the mouse (fix resizing the wrong pane in some
1215  layouts, and allow resizing multiple panes at the same time).
1216
1217* Allow , and } to be escaped in formats as #, and #}.
1218
1219* Add KRB5CCNAME to update-environment.
1220
1221* Change meaning of -c to display-message so the client is used if it
1222  matches the session given to -t.
1223
1224* Fixes to : form of SGR.
1225
1226* Add x and X to choose-tree to kill sessions, windows or panes.
1227
1228CHANGES FROM 2.6 TO 2.7
1229
1230* Remove EVENT_* variables from environment on platforms where tmux uses them
1231  so they do not pass on to panes.
1232
1233* Fixes for hooks at server exit.
1234
1235* Remove SGR 10 (was equivalent to SGR 0 but no other terminal seems to do
1236  this).
1237
1238* Expand formats in window and session names.
1239
1240* Add -Z flag to choose-tree, choose-client, choose-buffer to automatically
1241  zoom the pane when the mode is entered and unzoom when it exits, assuming the
1242  pane is not already zoomed. This is now part of the default key bindings.
1243
1244* Add C-g to exit modes with emacs keys.
1245
1246* Add exit-empty option to exit server if no sessions (defaults to on).
1247
1248* Show if a filter is present in choose modes.
1249
1250* Add pipe-pane -I to to connect stdin of the child process.
1251
1252* Performance improvements for reflow.
1253
1254* Use RGB terminfo(5) capability to detect RGB colour terminals (the existing
1255  Tc extension remains unchanged).
1256
1257* Support for ISO colon-separated SGR sequences.
1258
1259* Add select-layout -E to spread panes out evenly (bound to E key).
1260
1261* Support wide characters properly when reflowing.
1262
1263* Pass PWD to new panes as a hint to shells, as well as calling chdir().
1264
1265* Performance improvements for the various choose modes.
1266
1267* Only show first member of session groups in tree mode (-G flag to choose-tree
1268  to show all).
1269
1270* Support %else in config files to match %if; from Brad Town in GitHub issue
1271  1071.
1272
1273* Fix "kind" terminfo(5) capability to be S-Down not S-Up.
1274
1275* Add a box around the preview label in tree mode.
1276
1277* Show exit status and time in the remain-on-exit pane text; from Timo
1278  Boettcher in GitHub issue 1103.
1279
1280* Correctly use pane-base-index in tree mode.
1281
1282* Change the allow-rename option default to off.
1283
1284* Support for xterm(1) title stack escape sequences (GitHub issue 1075 from
1285  Brad Town).
1286
1287* Correctly remove padding cells to fix a UTF-8 display problem (GitHub issue
1288  1090).
1289
1290CHANGES FROM 2.5 TO 2.6, 05 October 2017
1291
1292* Add select-pane -T to set pane title.
1293
1294* Fix memory leak when lines with BCE are removed from history.
1295
1296* Fix (again) the "prefer unattached" behaviour of attach-session.
1297
1298* Reorder how keys are checked to allow keys to be specified that have a
1299  leading escape. GitHub issue 1048.
1300
1301* Support REP escape sequence (\033[b).
1302
1303* Run alert hooks based on options rather than always, and allow further bells
1304  even if there is an existing bell.
1305
1306* Add -d flag to display-panes to override display-panes-time.
1307
1308* Add selection_present format when in copy mode (allows key bindings that do
1309  something different if there is a selection).
1310
1311* Add pane_at_left, pane_at_right, pane_at_top and pane_at_bottom formats.
1312
1313* Make bell, activity and silence alerting more consistent by: removing the
1314  bell-on-alert option; adding activity-action and silence-action options with
1315  the same possible values as the existing bell-action; adding a "both" value
1316  for the visual-bell, visual-activity and visual-silence options to trigger
1317  both a bell and a message.
1318
1319* Add a pane_pipe format to show if pipe-pane is active.
1320
1321* Block signals between forking and resetting signal handlers so that the
1322  libevent signal handler doesn't get called in the child and incorrectly write
1323  into the signal pipe that it still shares with the parent. GitHub issue 1001.
1324
1325* Allow punctuation in pane_current_command.
1326
1327* Add -c for respawn-pane and respawn-window.
1328
1329* Wait for any remaining data to flush when a pane is closed while pipe-pane is
1330  in use.
1331
1332* Fix working out current client with no target. GitHub issue 995.
1333
1334* Try to fallback to C.UTF-8 as well as en_US.UTF-8 when looking for a UTF-8
1335  locale.
1336
1337* Add user-keys option for user-defined key escape sequences (mapped to User0
1338  to User999 keys).
1339
1340* Add pane-set-clipboard hook.
1341
1342* FAQ file has moved out of repository to online.
1343
1344* Fix problem with high CPU usage when a client dies unexpectedly. GitHub issue
1345  941.
1346
1347* Do a dance on OS X 10.10 and above to return tmux to the user namespace,
1348  allowing access to the clipboard.
1349
1350* Do not allow escape sequences which expect a specific terminator (APC, DSC,
1351  OSC) to wait for forever - use a small timeout. This reduces the chance of
1352  the pane locking up completely when sent garbage (cat /dev/random or
1353  similar).
1354
1355* Support SIGUSR2 to toggle logging on a running server, also generate the
1356  "out" log file with -vv not -vvvv.
1357
1358* Make set-clipboard a three state option: on (tmux both sends to outside
1359  terminal and accepts from applications inside); external (tmux sends outside
1360  but does not accept inside); and off.
1361
1362* Fix OSC 4 palette setting for bright foreground colours. GitHub issue 954.
1363
1364* Use setrgbf and setrgbb terminfo(5) capabilities to set RGB colours, if they
1365  are available. (Tc is still supported as well.)
1366
1367* Fix redrawing panes when they are resized several times but end up with the
1368  size unchanged (for example, splitw/resizep -Z/breakp).
1369
1370* Major rewrite of choose mode. Now includes preview, sorting, searching and
1371  tagging; commands that can be executed directly from the mode (for example,
1372  to delete one or more buffers); and filtering in tree mode.
1373
1374* choose-window and choose-session are now aliases of choose-tree (in the
1375  command-alias option).
1376
1377* Support OSC 10 and OSC 11 to set foreground and background colours.
1378
1379* Check the U8 capability to determine whether to use UTF-8 line drawing
1380  characters for ACS.
1381
1382* Some missing notifications for layout changes.
1383
1384* Control mode clients now do not affect session sizes until they issue
1385  refresh-client -C. new-session -x and -y works with control clients even if
1386  the session is not detached.
1387
1388* All new sessions that are unattached (whether with -d or started with no
1389  terminal) are now created with size 80 x 24. Whether the status line is on or
1390  off does not affect the size of new sessions until they are attached.
1391
1392* Expand formats in option names and add -F flag to expand them in option values.
1393
1394* Remember the search string for a pane even if copy mode is exited and entered
1395  again.
1396
1397* Some further BCE fixes (scroll up, reverse index).
1398
1399* Improvements to how terminals are cleared (entirely or partially).
1400
1401CHANGES FROM 2.4 TO 2.5, 09 May 2017
1402
1403* Reset updated flag when restarting #() command so that new output is properly
1404  recognised. GitHub issue 922.
1405
1406* Fix ECH with a background colour.
1407
1408* Do not rely on the terminal not moving the cursor after DL or EL.
1409
1410* Fix send-keys and send-prefix in copy-mode (so C-b C-b works). GitHub issue
1411  905.
1412
1413* Set the current pane for rotate-window so it works in command sequences.
1414
1415* Add pane_mode format.
1416
1417* Differentiate M-Up from Escape+Up when possible (that is, in terminals with
1418  xterm(1) style function keys). GitHub issue 907.
1419
1420* Add session_stack and window_stack_index formats.
1421
1422* Some new control mode notifications and corresponding hooks:
1423  pane-mode-changed, window-pane-changed, client-session-changed,
1424  session-window-changed.
1425
1426* Format pane_search_string for last search term while in copy mode (useful
1427  with command-prompt -I).
1428
1429* Fix a problem with high CPU usage and multiple clients with #(). GitHub issue
1430  889.
1431
1432* Fix UTF-8 combining characters in column 0.
1433
1434* Fix reference counting so that panes are properly destroyed and their
1435  processes killed.
1436
1437* Clamp SU (CSI S) parameter to work around a bug in Konsole.
1438
1439* Tweak line wrapping in full width panes to play more nicely with terminal
1440  copy and paste.
1441
1442* Fix when we emit SGR 0 in capture-pane -e.
1443
1444* Do not change TERM until after config file parsing has finished, so that
1445  commands run inside the config file can use it to make decisions (typically
1446  about default-terminal).
1447
1448* Make the initial client wait until config file parsing has finished to avoid
1449  racing with commands.
1450
1451* Fix core when if-shell fails.
1452
1453* Only use ED to clear screen if the pane is at the bottom.
1454
1455* Fix multibyte UTF-8 output.
1456
1457* Code improvements around target (-t) resolution.
1458
1459* Change how the default target (for commands without -t) is managed across
1460  command sequences: now it is set up at the start and commands are required
1461  to update it if needed. Fixes binding command sequences to mouse keys.
1462
1463* Make if-shell from the config file work correctly.
1464
1465* Change to always check the root key table if no binding is found in the
1466  current table (prefix table or copy-mode table or whatever). This means that
1467  root key bindings will take effect even in copy mode, if not overridden by a
1468  copy mode key binding.
1469
1470* Fix so that the history file works again.
1471
1472* Run config file without a client rather than using the first client, restores
1473  previous behaviour.
1474
1475* If a #() command doesn't exit, continue to read from it and use its last full
1476  line of output.
1477
1478* Handle slow terminals and fast output better: when the amount of data
1479  outstanding gets too large, discard output until it is drained and we are
1480  able to do a full redraw. Prevents tmux sitting on a huge buffer that the
1481  terminal will take forever to consume.
1482
1483* Do not redraw a client unless we realistically think it can accept the data -
1484  defer redraws until the client has nothing else waiting to write.
1485
1486CHANGES FROM 2.3 TO 2.4, 20 April 2017
1487
1488Incompatible Changes
1489====================
1490
1491* Key tables have undergone major changes. Mode key tables are no longer
1492  separate from the main key tables. All mode key tables have been removed,
1493  together with the -t flag to bind-key and unbind-key.
1494
1495  The emacs-edit, vi-edit, emacs-choose and vi-choose tables have been replaced
1496  by fixed key bindings in the command prompt and choose modes. The mode-keys
1497  and status-keys options remain.
1498
1499  The emacs-copy and vi-copy tables have been replaced by the copy-mode and
1500  copy-mode-vi tables. Commands are sent using the -X and -N flags to
1501  send-keys. So the following:
1502
1503    bind -temacs-copy C-Up scroll-up
1504    bind -temacs-copy -R5 WheelUpPane scroll-up
1505
1506  Becomes:
1507
1508    bind -Tcopy-mode C-Up send -X scroll-up
1509    bind -Tcopy-mode WheelUpPane send -N5 -X scroll-up
1510
1511  These changes allows the full command parser (including command sequences) and
1512  command set to be used - for example, the normal command prompt with editing
1513  and history is now used for searching, jumping, and so on instead of a custom
1514  one. The default C-r binding is now:
1515
1516    bind -Tcopy-mode C-r command-prompt -i -p'search up' "send -X search-backward-incremental '%%'"
1517
1518  There are also some new commands available with send -X, such as
1519  copy-pipe-and-cancel.
1520* set-remain-on-exit has gone -- can be achieved with hooks instead.
1521* Hooks: before hooks have been removed and only a selection of commands now
1522  have after hooks (they are no longer automatic). Additional hooks have been
1523  added.
1524* The xterm-keys option now defaults to on.
1525
1526Normal Changes
1527==============
1528
1529* Support for mouse double and triple clicks.
1530* BCE (Background Colour Erase) is now supported.
1531* All occurrences of a search string in copy mode are now highlighted;
1532  additionally, the number of search results is displayed. The highlighting
1533  updates interactively with the default emacs key bindings (incremental
1534  search).
1535* source-file now understands glob patterns.
1536* Formats now have simple comparisons:
1537
1538    #{==:a,b}
1539    #{!=:a,b}
1540
1541* There are the following new formats:
1542
1543  - #{version} -- the tmux server version;
1544  - #{client_termtype} -- the terminal type of the client;
1545  - #{client_name} -- the name of a client;
1546  - #{client_written} -- the number of bytes written to the client.
1547
1548* The configuration file now accepts %if/%endif conditional blocks which are
1549  processed when it is parsed; the argument is a format string (useful with the
1550  new format comparison options).
1551* detach-client now has -E to execute a command replacing the client instead of
1552  exiting.
1553* Add support for custom command aliases, this is an array option which
1554  contains items of the form "alias=command". This is consulted when an
1555  unknown command is parsed.
1556* break-pane now has -n to specify the new window name.
1557* OSC 52 support has been added for programs inside tmux to set a tmux buffer.
1558* The mouse "all event" mode (1003) is now supported.
1559* Palette setting is now possible (OSC 4 and 104).
1560* Strikethrough support (a recent terminfo is required).
1561* Grouped sessions can now be named (new -t).
1562* terminal-overrides and update-environment are now array options (the previous
1563  set -ag syntax should work without change).
1564* There have been substantial performance improvements.
1565
1566CHANGES FROM 2.2 TO 2.3, 29 September 2016
1567
1568Incompatible Changes
1569====================
1570
1571None.
1572
1573Normal Changes
1574==============
1575
1576* New option 'pane-border-status' to add text in the pane borders.
1577* Support for hooks on commands: 'after' and 'before' hooks.
1578* 'source-file' understands '-q' to suppress errors for nonexistent files.
1579* Lots of UTF8 improvements, especially on MacOS.
1580* 'window-status-separator' understands #[] expansions.
1581* 'split-window' understands '-f' for performing a full-width split.
1582* Allow report count to be specified when using 'bind-key -R'.
1583* 'set -a' for appending to user options (@foo) is now supported.
1584* 'display-panes' can now accept a command to run, rather than always
1585  selecting the pane.
1586
1587CHANGES FROM 2.1 TO 2.2, 10 April 2016
1588
1589Incompatible Changes
1590====================
1591
1592* The format strings which referenced time have been removed.  Instead:
1593
1594  #{t:window_activity}
1595
1596can be used.
1597
1598* Support for TMPDIR has been removed.  Use TMUX_TMPDIR instead.
1599* UTF8 detection now happens automatically if the client supports it, hence
1600  the:
1601
1602  mouse-utf8
1603  utf8
1604
1605  options has been removed.
1606* The:
1607
1608  mouse_utf8_flag
1609
1610  format string has been removed.
1611* The -I option to show-messages has been removed.  See:
1612
1613  #{t:start_time}
1614
1615  format option instead.
1616
1617Normal Changes
1618==============
1619
1620* Panes are unzoomed with selectp -LRUD
1621* New formats added:
1622
1623  #{scroll_position}
1624  #{socket_path}
1625  #{=10:...} -- limit to N characters (from the start)
1626  #{=-10:...} -- limit to N characters (from the end)
1627  #{t:...} -- used to format time-based formats
1628  #{b:...} -- used to ascertain basename from string
1629  #{d:...} -- used to ascertain dirname from string
1630  #{s:...} -- used to perform substitutions on a string
1631
1632* Job output is run via the format system, so formats work again
1633* If display-time is set to 0, then the indicators wait for a key to be
1634  pressed.
1635* list-keys and list-commands can be run without starting the tmux server.
1636* kill-session learns -C to clear all alerts in all windows of the session.
1637* Support for hooks (internal for now), but hooks for the following have been
1638  implemented:
1639
1640  alert-bell
1641  alert-silence
1642  alert-activity
1643  client-attached
1644  client-detached
1645  client-resized
1646  pane-died
1647  pane-exited
1648
1649* RGB (24bit) colour support.  The 'Tc' flag must be set in the external TERM
1650  entry (using terminal-overrides or a custom terminfo entry).
1651
1652CHANGES FROM 2.0 TO 2.1, 18 October 2015
1653
1654Incompatible Changes
1655====================
1656
1657* Mouse-mode has been rewritten.  There's now no longer options for:
1658	- mouse-resize-pane
1659	- mouse-select-pane
1660	- mouse-select-window
1661	- mode-mouse
1662
1663  Instead there is just one option:  'mouse' which turns on mouse support
1664  entirely.
1665* 'default-terminal' is now a session option.  Furthermore, if this is set
1666  to 'screen-*' then emulate what screen does.  If italics are wanted, this
1667  can be set to 'tmux' but this is still new and not necessarily supported
1668  on all platforms with older ncurses installs.
1669* The c0-* options for rate-limiting have been removed.  Instead, a backoff
1670  approach is used.
1671
1672Normal Changes
1673==============
1674
1675* New formats:
1676	- session_activity
1677	- window_linked
1678	- window_activity_format
1679	- session_alerts
1680	- session_last_attached
1681	- client_pid
1682	- pid
1683* 'copy-selection', 'append-selection', 'start-named-buffer' now understand
1684  an '-x' flag to prevent it exiting copying mode.
1685* 'select-pane' now understands '-P' to set window/pane background colours.
1686* 'renumber-windows' now understands windows which are unlinked.
1687* 'bind' now understands multiple key tables.  Allows for key-chaining.
1688* 'select-layout' understands '-o' to undo the last layout change.
1689* The environment is updated when switching sessions as well as attaching.
1690* 'select-pane' now understands '-M' for marking a pane.  This marked pane
1691  can then be used with commands which understand src-pane specifiers
1692  automatically.
1693* If a session/window target is prefixed with '=' then only an exact match
1694  is considered.
1695* 'move-window' understands '-a'.
1696* 'update-environment' understands '-E' when attach-session is used on an
1697  already attached client.
1698* 'show-environment' understands '-s' to output Bourne-compatible commands.
1699* New option: 'history-file' to save/restore command prompt history.
1700* Copy mode is exited if the history is cleared whilst in copy-mode.
1701* 'copy-mode' learned '-e' to exit copy-mode when scrolling to end.
1702
1703CHANGES FROM 1.9a TO 2.0, 06 March 2015
1704
1705Incompatible Changes
1706====================
1707
1708* The choose-list command has been removed.
1709* 'terminal-overrides' is now a server option, not a session option.
1710* 'message-limit' is now a server option, not a session option.
1711* 'monitor-content' option has been removed.
1712* 'pane_start_path' option has been removed.
1713* The "info" mechanism which used to (for some commands) provide feedback
1714  has been removed, and like other commands, they now produce nothing on
1715  success.
1716
1717Normal Changes
1718==============
1719
1720* tmux can now write an entry to utmp if the library 'utempter' is present
1721  at compile time.
1722* set-buffer learned append mode (-a), and a corresponding
1723  'append-selection' command has been added to copy-mode.
1724* choose-mode now has the following commands which can be bound:
1725	- start-of-list
1726	- end-of-list
1727	- top-line
1728	- bottom-line
1729
1730* choose-buffer now understands UTF-8.
1731* Pane navigation has changed:
1732	- The old way of always using the top or left if the choice is ambiguous.
1733	- The new way of remembering the last used pane is annoying if the
1734	  layout is balanced and the leftmost is obvious to the user (because
1735	  clearly if we go right from the top-left in a tiled set of four we want
1736	  to end up in top-right, even if we were last using the bottom-right).
1737
1738      So instead, use a combination of both: if there is only one possible
1739      pane alongside the current pane, move to it, otherwise choose the most
1740      recently used of the choice.
1741* 'set-buffer' can now be told to give names to buffers.
1742* The 'new-session', 'new-window', 'split-window', and 'respawn-pane' commands
1743  now understand multiple arguments and handle quoting problems correctly.
1744* 'capture-pane' understands '-S-' to mean the start of the pane, and '-E-' to
1745  mean the end of the pane.
1746* Support for function keys beyond F12 has changed.  The following explains:
1747	- F13-F24 are S-F1 to S-F12
1748	- F25-F36 are C-F1 to C-F12
1749	- F37-F48 are C-S-F1 to C-S-F12
1750	- F49-F60 are M-F1 to M-F12
1751	- F61-F63 are M-S-F1 to M-S-F3
1752
1753 Therefore, F13 becomes a binding of S-F1, etc.
1754* Support using pane id as part of session or window specifier (so % means
1755  session-of-%1 or window-of-%1) and window id as part of session
1756  (so @1 means session-of-@1).
1757* 'copy-pipe' command now understands formats via -F
1758* 'if-shell'  command now understands formats via -F
1759* 'split-window' and 'join-window' understand -b to create the pane to the left
1760  or above the target pane.
1761
1762CHANGES FROM 1.9 TO 1.9a, 22 February 2014
1763
1764NOTE: This is a bug-fix release to address some important bugs which just
1765missed the 1.9 deadline, but were found afterwards.
1766
1767Normal Changes
1768==============
1769
1770* Fix crash due to uninitialized lastwp member of layout_cell
1771* Fix -fg/-bg/-style with 256 colour terminals.
1772
1773CHANGES FROM 1.8 TO 1.9, 20 February 2014
1774
1775NOTE:  This release has bumped the tmux protocol version.  It is therefore
1776advised that the prior tmux server is restarted when this version of tmux is
1777installed, to avoid protocol mismatch errors for newer clients trying to
1778talk to an older running tmux server.
1779
1780Incompatible Changes
1781====================
1782
1783* 88 colour support has been removed.
1784* 'default-path' has been removed.  The new-window command accepts '-c' to
1785  cater for this.  The previous value of "." can be replaced with: 'neww -c
1786  $PWD', the previous value of '' which meant current path of the pane can
1787  be specified as:  'neww -c "#{pane_current_path}"'
1788
1789Deprecated Changes
1790==================
1791
1792* The single format specifiers:  #A -> #Z (where defined) have been
1793  deprecated and replaced with longer-named equivalents, as listed in the
1794  FORMATS section of the tmux manpage.
1795* The various foo-{fg,bg,attr} commands have been deprecated and replaced
1796  with equivalent foo-style option instead.  Currently this is still
1797  backwards-compatible, but will be removed over time.
1798
1799Normal Changes
1800==============
1801
1802* A new environment variable TMUX_TMPDIR is now honoured, allowing the
1803  socket directory to be set outside of TMPDIR (/tmp/ if not set).
1804* If -s not given to swap-pane the current pane is assumed.
1805* A #{pane_synchronized} format specifier has been added to be a conditional
1806  format if a pane is in a synchronised mode (c.f. synchronize-panes)
1807* Tmux now runs under Cygwin natively.
1808* Formats can now be nested within each other and expanded accordingly.
1809* Added 'automatic-rename-format' option to allow the automatic rename
1810  mechanism to use something other than the default of
1811  #{pane_current_command}.
1812* new-session learnt '-c' to specify the starting directory for that session
1813  and all subsequent windows therein.
1814* The session name is now shown in the message printed to the terminal when
1815  a session is detached.
1816* Lots more format specifiers have been added.
1817* Server race conditions have been fixed; in particular commands are not run
1818  until after the configuration file is read completely.
1819* Case insensitive searching in tmux's copy-mode is now possible.
1820* attach-session and switch-client learnt the '-t' option to accept a window
1821  and/or a pane to use.
1822* Copy-mode is only exited if no selection is in progress.
1823* Paste key in copy-mode is now possible to enter text from the clipboard.
1824* status-interval set to '0' now works as intended.
1825* tmux now supports 256 colours running under fbterm.
1826* Many bug fixes!
1827
1828CHANGES FROM 1.7 TO 1.8, 26 March 2013
1829
1830Incompatible Changes
1831====================
1832
1833* layout redo/undo has been removed.
1834
1835Normal Changes
1836==============
1837
1838* Add halfpage up/down bindings to copy mode.
1839* Session choosing fixed to work with unattached sessions.
1840* New window options window-status-last-{attr,bg,fg} to denote the last
1841  window which was active.
1842* Scrolling in copy-mode now scrolls the region without moving the mouse
1843  cursor.
1844* run-shell learnt '-t' to specify the pane to use when displaying output.
1845* Support for middle-click pasting.
1846* choose-tree learns '-u' to start uncollapsed.
1847* select-window learnt '-T' to toggle to the last window if it's already
1848  current.
1849* New session option 'assume-paste-time' for pasting text versus key-binding
1850  actions.
1851* choose-* commands now work outside of an attached client.
1852* Aliases are now shown for list-commands command.
1853* Status learns about formats.
1854* Free-form options can be set with set-option if prepended with an '@'
1855  sign.
1856* capture-pane learnt '-p' to send to stdout, and '-e' for capturing escape
1857  sequences, and '-a' to capture the alternate screen, and '-P' to dump
1858  pending output.
1859* Many new formats added (client_session, client_last_session, etc.)
1860* Control mode, which is a way for a client to send tmux commands.
1861  Currently more useful to users of iterm2.
1862* resize-pane learnt '-x' and '-y' for absolute pane sizing.
1863* Config file loading now reports errors from all files which are loaded via
1864  the 'source-file' command.
1865* 'copy-pipe' mode command to copy selection and pipe the selection to a
1866  command.
1867* Panes can now emit focus notifications for certain applications
1868  which use those.
1869* run-shell and if-shell now accept formats.
1870* resize-pane learnt '-Z' for zooming a pane temporarily.
1871* new-session learnt '-A' to make it behave like attach-session.
1872* set-option learnt '-o' to prevent setting an option which is already set.
1873* capture-pane and show-options learns '-q' to silence errors.
1874* New command 'wait-for' which blocks a client until woken up again.
1875* Resizing panes will now reflow the text inside them.
1876* Lots and lots of bug fixes, fixing memory-leaks, etc.
1877* Various manpage improvements.
1878
1879CHANGES FROM 1.6 TO 1.7, 13 October 2012
1880
1881* tmux configuration files now support line-continuation with a "\" at the
1882  end of a line.
1883* New option status-position to move the status line to the top or bottom of
1884  the screen.
1885* Enforce history-limit option when clearing the screen.
1886* Give each window a unique id, like panes but prefixed with @.
1887* Add pane id to each pane in layout description (while still accepting
1888  the old form).
1889* Provide defined ways to set the various default-path possibilities: ~
1890  for home directory, . for server start directory, - for session start
1891  directory and empty for the pane's working directory (the default). All
1892  can also be used as part of a relative path (eg -/foo). Also provide -c
1893  flags to neww and splitw to override default-path setting.
1894* Add -l flag to send-keys to send input literally (without translating
1895  key names).
1896* Allow a single option to be specified to show-options to show just that
1897  option.
1898* New command "move-pane" (like join-pane but allows the same window).
1899* join-pane and move-pane commands learn "-b" option to place the pane to
1900  the left or above.
1901* Support for bracketed-paste mode.
1902* Allow send-keys command to accept hex values.
1903* Add locking around "start-server" to avoid race-conditions.
1904* break-pane learns -P/-F arguments for display formatting.
1905* set-option learns "-q" to make it quiet, and not print out anything.
1906* copy mode learns "wrap-search" option.
1907* Add a simple form of output rate limiting by counting the number of
1908  certain C0 sequences (linefeeds, backspaces, carriage returns) and if it
1909  exceeds a threshold (current default 250/millisecond), start to redraw
1910  the pane every 100 milliseconds instead of making each change as it
1911  comes. Two configuration options - c0-change-trigger and
1912  c0-change-interval.
1913* find-window learns new flags:  "-C", "-N", "-T" to match against either or
1914  all of a window's content, name, or title.  Defaults to all three options
1915  if none specified.
1916* find-window automatically selects the appropriate pane for the found
1917  matches.
1918* show-environment can now accept one option to show that environment value.
1919* Exit mouse mode when end-of-screen reached when scrolling with the mouse
1920  wheel.
1921* select-layout learns -u and -U for layout history stacks.
1922* kill-window, detach-client, kill-session all  learn "-a" option for
1923  killing all but the current thing specified.
1924* move-window learns "-r" option to renumber window sequentially in a
1925  session.
1926* New session option "renumber-windows" to automatically renumber windows in
1927  a session when a window is closed.  (see "move-window -r").
1928* Only enter copy-mode on scroll up.
1929* choose-* and list-* commands all use "-F" for format specifiers.
1930* When spawning external commands, the value from the "default-shell" option
1931  is now used, rather than assuming /bin/sh.
1932* New choose-tree command to render window/sessions as a tree for selection.
1933* display-message learns new format options.
1934* For linked-windows across sessions, all flags for that window are now
1935  cleared across sessions.
1936* Lots and lots of bug fixes, fixing memory-leaks, etc.
1937* Various manpage improvements.
1938
1939CHANGES FROM 1.5 TO 1.6, 23 January 2012
1940
1941* Extend the mode-mouse option to add a third choice which means the mouse
1942  does not enter copy mode.
1943* Add a -r flag to switch-client to toggle the client read-only flag.
1944* Add pane-base-index option.
1945* Support \ for line continuation in the configuration file.
1946* Framework for more powerful formatting of command output and use it for
1947  list-{panes,windows,sessions}. This allows more descriptive replacements
1948  (such as #{session_name}) and conditionals.
1949* Mark dead panes with some text saying they are dead.
1950* Reject $SHELL if it is not a full path.
1951* Add -S option to refresh-client to redraw status line.
1952* Add an else clause for if-shell.
1953* Try to resolve relative paths for loadb and saveb (first, using client
1954  working directory, if any, then default-path or session working directory).
1955* Support for \e[3J to clear the history and send the corresponding
1956  terminfo code (E3) before locking.
1957* When in copy mode, make repeat count indicate buffer to replace, if used.
1958* Add screen*:XT to terminal-overrides for tmux-in-tmux.
1959* Status-line message attributes added.
1960* Move word-separators to be a session rather than window option.
1961* Change the way the working directory for new processes is discovered. If
1962  default-path isn't empty, it is used. Otherwise, if a new window is created
1963  from the command-line, the working directory of the client is used. If not,
1964  platform specific code is used to retrieve the current working directory
1965  of the process in the active pane. If that fails, the directory where the
1966  session was created is used, instead.
1967* Do not change the current pane if both mouse-select-{pane,window} are
1968  enabled.
1969* Add \033[s and \033[u to save and restore cursor position.
1970* Allow $HOME to be used as default-path.
1971* Add CNL and CPL escape sequences.
1972* Calculate last position correctly for UTF-8 wide characters.
1973* Add an option allow-rename to disable the window rename escape sequence.
1974* Attributes for each type of status-line alert (ie bell, content and
1975  activity) added. Therefore, remove the superfluous options
1976  window-status-alert-{attr,bg,fg}.
1977* Add a -R flag to send-keys to reset the terminal.
1978* Add strings to allow the aixterm bright colours to be used when
1979  configuring colours.
1980* Drop the ability to have a list of keys in the prefix in favour of two
1981  separate options, prefix and prefix2.
1982* Flag -2 added to send-prefix to send the secondary prefix key.
1983* Show pane size in top right of display panes mode.
1984* Some memory leaks plugged.
1985* More command-prompt editing improvements.
1986* Various manpage improvements.
1987* More Vi mode improvements.
1988
1989CHANGES FROM 1.4 TO 1.5, 09 July 2011
1990
1991* Support xterm mouse modes 1002 and 1003.
1992* Change from a per-session stack of buffers to one global stack. This renders
1993  copy-buffer useless and makes buffer-limit now a server option.
1994* Fix most-recently-used choice by avoiding reset the activity timer for
1995  unattached sessions every second.
1996* Add a -P option to new-window and split-window to print the new window or
1997  pane index in target form (useful to pass it into other commands).
1998* Handle a # at the end of a replacement string (such as status-left)
1999  correctly.
2000* Support for UTF-8 mouse input (\033[1005h) which was added in xterm 262.
2001  If the new mouse-utf8 option is on, UTF-8 mouse input is enabled for all
2002  UTF-8 terminals. The option defaults to on if LANG etc are set in the same
2003  manner as the utf8 option.
2004* Support for HP-UX.
2005* Accept colours of the hex form #ffffff and translate to the nearest from the
2006  xterm(1) 256-colour set.
2007* Clear the non-blocking IO flag (O_NONBLOCK) on the stdio file descriptors
2008  before closing them (fixes things like "tmux ls && cat").
2009* Use TMPDIR if set.
2010* Fix next and previous session functions to actually work.
2011* Support -x and -y for new-session to specify the initial size of the window
2012  if created detached with -d.
2013* Make bind-key accept characters with the top-bit-set and print them as octal.
2014* Set $TMUX without the session when background jobs are run.
2015* Simplify the way jobs work and drop the persist type, so all jobs are
2016  fire-and-forget.
2017* Accept tcgetattr/tcsetattr(3) failure, fixes problems with fatal() if the
2018  terminal disappears while locked.
2019* Add a -P option to detach to HUP the client's parent process (usually causing
2020  it to exit as well).
2021* Support passing through escape sequences to the underlying terminal by using
2022  DCS with a "tmux;" prefix.
2023* Prevent tiled producing a corrupt layout when only one column is needed.
2024* Give each pane created in a tmux server a unique id (starting from 0), put it
2025  in the TMUX_PANE environment variable and accept it as a target.
2026* Allow a start and end line to be specified for capture-pane which may be
2027  negative to capture part of the history.
2028* Add -a and -s options to lsp to list all panes in the server or session
2029  respectively. Likewise add -s to lsw.
2030* Change -t on display-message to be target-pane for the #[A-Z] replacements
2031  and add -c as target-client.
2032* The attach-session command now prefers the most recently used unattached
2033  session.
2034* Add -s option to detach-client to detach all clients attached to a session.
2035* Add -t to list-clients.
2036* Change window with mouse wheel over status line if mouse-select-window is on.
2037* When mode-mouse is on, automatically enter copy mode when the mouse is
2038  dragged or the mouse wheel is used. Also exit copy mode when the mouse wheel
2039  is scrolled off the bottom.
2040* Provide #h character pair for short hostname (no domain).
2041* Don't use strnvis(3) for the title as it breaks UTF-8.
2042* Use the tsl and fsl terminfo(5) capabilities to update terminal title and
2043  automatically fill them in on terminals with the XT capability (which means
2044  their title setting is xterm-compatible).
2045* Add a new option, mouse-resize-pane. When on, panes may be resized by
2046  dragging their borders.
2047* Fix crash by resetting last pane on {break,swap}-pane across windows.
2048* Add three new copy-mode commands - select-line, copy-line, copy-end-of-line.
2049* Support setting the xterm clipboard when copying from copy mode using the
2050  xterm escape sequence for the purpose (if xterm is configured to allow it).
2051* Support xterm(1) cursor colour change sequences through terminfo(5) Cc
2052  (set) and Cr (reset) extensions.
2053* Support DECSCUSR sequence to set the cursor style with two new terminfo(5)
2054  extensions, Cs and Csr.
2055* Make the command-prompt custom prompts recognize the status-left option
2056  character pairs.
2057* Add a respawn-pane command.
2058* Add a couple of extra xterm-style keys that gnome terminal provides.
2059* Allow the initial context on prompts to be set with the new -I option to
2060  command-prompt. Include the current window and session name in the prompt
2061  when renaming and add a new key binding ($) for rename session.
2062* Option bell-on-alert added to trigger the terminal bell when there is an
2063  alert.
2064* Change the list-keys format so that it shows the keys using actual tmux
2065  commands which should be able to be directly copied into the config file.
2066* Show full targets for lsp/lsw -a.
2067* Make confirm-before prompt customizable with -p option like command-prompt
2068  and add the character pairs #W and #P to the default kill-{pane,window}
2069  prompts.
2070* Avoid sending data to suspended/locked clients.
2071* Small memory leaks in error paths plugged.
2072* Vi mode improvements.
2073
2074CHANGES FROM 1.3 TO 1.4, 27 December 2010
2075
2076* Window bell reporting fixed.
2077* Show which pane is active in the list-panes output.
2078* Backoff reworked.
2079* Prevent the server from dying when switching into copy mode when already
2080  in a different mode.
2081* Reset running jobs when the status line is enabled or disabled.
2082* Simplify xterm modifier detection.
2083* Avoid crashing in copy mode if the screen size is too small for the
2084  indicator.
2085* Flags -n and -p added to switch-client.
2086* Use UTF-8 line drawing characters on UTF-8 terminals, thus fixing some
2087  terminals (eg putty) which disable the vt100 ACS mode switching sequences
2088  in UTF-8 mode. On terminals without ACS, use ASCII equivalents.
2089* New server option exit-unattached added.
2090* New session option destroy-unattached added.
2091* Fall back on normal session choice method if $TMUX exists but is invalid
2092  rather than rejecting.
2093* Mark repeating keys with "(repeat)" in the key list.
2094* When removing a pane, don't change the active pane unless the active pane
2095  is actually the one being removed.
2096* New command last-pane added.
2097* AIX fixes.
2098* Flag -a added to unbind-key.
2099* Add XAUTHORITY to update-environment.
2100* More info regarding window and pane flags is now shown in list-*.
2101* If VISUAL or EDITOR contains "vi" configure mode-keys and status-key to vi.
2102* New window option monitor-silence and session option visual-silence added.
2103* In the built-in layouts distribute the panes more evenly.
2104* Set the default value of main-pane-width to 80 instead of 81.
2105* Command-line flag -V added.
2106* Instead of keeping a per-client prompt history make it global.
2107* Fix rectangle copy to behave like emacs (the cursor is not part of the
2108  selection on the right edge but on the left it is).
2109* Flag -l added to switch-client.
2110* Retrieve environment variables from the global environment rather than
2111  getenv(3), thus allowing them to be updated during the configuration file.
2112* New window options other-pane-{height,width} added.
2113* More minor bugs fixed and manpage improvements.
2114
2115CHANGES FROM 1.2 TO 1.3, 18 July 2010
2116
2117* New input parser.
2118* Flags to move through panes -UDLR added to select-pane.
2119* Commands up-pane, and down-pane removed, since equivalent behaviour is now
2120  available through the target flag (-t:+ and -t:-).
2121* Jump-forward/backward in copy move (based on vi's F, and f commands).
2122* Make paste-buffer accept a pane as a target.
2123* Flag -a added to new-window to insert a window after an existing one, moving
2124  windows up if necessary.
2125* Merge more mode into copy mode.
2126* Run job commands explicitly in the global environment (which can be modified
2127  with setenv -g), rather than with the environment tmux started with.
2128* Use the machine's hostname as the default title, instead of an empty string.
2129* Prevent double free if the window option remain-on-exit is set.
2130* Key string conversions rewritten.
2131* Mark zombie windows as dead in the choose-window list.
2132* Tiled layout added.
2133* Signal handling reworked.
2134* Reset SIGCHLD after fork to fix problems with some shells.
2135* Select-prompt command removed. Therefore, bound ' to command-prompt -p index
2136  "select-window -t:%%" by default.
2137* Catch SIGHUP and terminate if running as a client, thus avoiding clients from
2138  being left hanging around when, for instance, a SSH session is disconnected.
2139* Solaris 9 fixes (such as adding compat {get,set}env(3) code).
2140* Accept none instead of default for attributes.
2141* Window options window-status-alert-{alert,bg,fg} added.
2142* Flag -s added to the paste-buffer command to specify a custom separator.
2143* Allow dragging to make a selection in copy mode if the mode-mouse option is
2144  set.
2145* Support the mouse scroll wheel.
2146* Make pipe-pane accept special character sequences (eg #I).
2147* Fix problems with window sizing when starting tmux from .xinitrc.
2148* Give tmux sockets (but not the containing folder) group permissions.
2149* Extend the target flags (ie -t) to accept an offset (for example -t:+2), and
2150  make it wrap windows, and panes.
2151* New command choose-buffer added.
2152* New server option detach-on-destroy to set what happens to a client when the
2153  session it is attached to is destroyed. If on (default), the client is
2154  detached. Otherwise, the client is switched to the most recently active of
2155  the remaining sessions.
2156* The commands load-buffer, and save-buffer now accept a dash (-) as the file
2157  to read from stdin, or write to stdout.
2158* Custom layouts added.
2159* Additional code reduction, bug fixes, and manpage enhancements.
2160
2161CHANGES FROM 1.1 TO 1.2, 10 March 2010
2162
2163* Switch to libevent.
2164* Emulate the ri (reverse index) capability, ergo allowing tmux to at least
2165  start on Sun consoles (TERM=sun, or sun-color).
2166* Assign each entry a number, or lowercase letter in choose mode, and accept
2167  that as a shortcut key.
2168* Permit top-bit-set characters to be entered in the status line.
2169* Mark no-prefix keys with (no prefix), rather than [] in list-keys.
2170* New command show-messages (alias showmsgs), and new session option
2171  message-limit, to show a per-client log of status lines messages up to the
2172  number defined by message-limit.
2173* Do not interpret #() for display-message to avoid leaking commands.
2174* New window options window-status-format, and window-status-current-format to
2175  control the format of each window in the status line.
2176* Add a -p flag to display-message to print the output, instead of displaying
2177  it in the status line.
2178* Emulate il1, dl1, ich1 to run with vt100 feature set.
2179* New command capture-pane (alias capturep) to copy the entire pane contents
2180  to a paste buffer.
2181* Avoid duplicating code by adding a -w flag to set-option, and show-options to
2182  set, and show window options. The commands set-window-option, and
2183  show-window-options are now aliases.
2184* Panes can now be referred to as top, bottom, top-left, etc.
2185* Add server-wide options, which can be set with set-option -s, and shown with
2186  show-options -s.
2187* New server option quiet (like -q from the command line).
2188* New server option escape-time to set the timeout used to detect if escapes
2189  are alone, part of a function key, or meta sequence.
2190* New session options pane-active-border-bg, pane-active-border-fg,
2191  pane-border-bg, and pane-border-fg to set pane colours.
2192* Make split-window accept a pane target, instead of a window.
2193* New command join-pane (alias joinp) to split, and move an existing pane into
2194  the space (the opposite of break-pane), thus simplifying calls to
2195  split-window, followed by move-window.
2196* Permit S- prefix on keys for shift when the terminal/terminfo supports them.
2197* Window targets (-t flag) can now refer to the last window (!), next (+), and
2198  previous (-) window by number.
2199* Mode keys to jump to the bottom/top of history, end of the next word, scroll
2200  up/down, and reverse search in copy mode.
2201* New session option display-panes-active-colour to display the active pane in
2202  a different colour with the display-panes command.
2203* Read the socket path from $TMUX if it's present, and -L, and -S are not
2204  given.
2205* Vi-style mode keys B, W, and E to navigate between words in copy mode.
2206* Start in more mode when configuration file errors are detected.
2207* Rectangle copy support added.
2208* If attach-session was specified with the -r flag, make the client read-only.
2209* Per-window alternate-screen option.
2210* Make load-buffer work with FIFOs.
2211* New window option word-separators to set the characters considered as word
2212  separators in copy mode.
2213* Permit keys in copy mode to be prefixed by a repeat count, entered with [1-9]
2214  in vi mode, or M-[1-9] in emacs mode.
2215* utf8 improvements.
2216* As usual, additional code reduction, bug fixes, and manpage enhancements.
2217
2218CHANGES FROM 1.0 TO 1.1, 05 November 2009
2219
2220* New run-shell (alias run) command to run an external command without a
2221  window, capture it's stdout, and send it to output mode.
2222* Ability to define multiple prefix keys.
2223* Internal locking mechanism removed. Instead, detach each client and run the
2224  external command specified in the new session option lock-command (by default
2225  lock -np), thus allowing the system password to be used.
2226* set-password command, and -U command line flag removed per the above change.
2227* Add support for -c command line flag to execute a shell command.
2228* New lock-client (alias lockc), and lock-session (alias locks) commands to
2229  lock a particular client, or all clients attached to a session.
2230* Support C-n/C-p/C-v/M-v with emacs keys in choice mode.
2231* Use : for goto line rather than g in vi mode.
2232* Try to guess which client to use when no target client was specified. Finds
2233  the current session, and if only one client is present, use it. Otherwise,
2234  return the most recently used client.
2235* Make C-Down/C-Up in copy mode scroll the screen down/up one line without
2236  moving the cursor.
2237* Scroll mode superseded by copy mode.
2238* New synchronize-panes window option to send all input to all other panes in
2239  the same window.
2240* New lock-server session option to lock, when off (on by default), each
2241  session when it has been idle for the lock-after-time setting. When on, the
2242  entire server locks when all sessions have been idle for their individual
2243  lock-after-time setting.
2244* Add support for grouped sessions which have independent name, options,
2245  current window, but where the linked windows are synchronized (ie creating,
2246  killing windows are mirrored between the sessions). A grouped session may be
2247  created by passing -t to new-session.
2248* New mouse-select-pane session option to select the current pane with the
2249  mouse.
2250* Queue, and run commands in the background for if-shell, status-left,
2251  status-right, and #() by starting each once every status-interval. Adds the
2252  capability to call some programs which would previously cause the server to
2253  hang (eg sleep/tmux). It also avoids running commands excessively (ie if used
2254  multiple times, it will be run only once).
2255* When a window is zombified and automatic-rename is on, append [dead] to the
2256  name.
2257* Split list-panes (alias lsp) off from list-windows.
2258* New pipe-pane (alias pipep) to redirect a pane output to an external command.
2259* Support for automatic-renames for Solaris.
2260* Permit attributes to be turned off in #[] by prefixing with no (eg nobright).
2261* Add H/M/L in vi mode, and M-R/M-r in emacs to move the cursor to the top,
2262  middle, and bottom of the screen.
2263* -a option added to kill-pane to kill all except current pane.
2264* The -d command line flag is now gone (can be replaced by terminal-overrides).
2265  Just use op/AX to detect default colours.
2266* input/tty/utf8 improvements.
2267* xterm-keys rewrite.
2268* Additional code reduction, and bug fixes.
2269
2270CHANGES FROM 0.9 TO 1.0, 20 September 2009
2271
2272* Option to alter the format of the window title set by tmux.
2273* Backoff for a while after multiple incorrect password attempts.
2274* Quick display of pane numbers (C-b q).
2275* Better choose-window, choose-session commands and a new choose-client command.
2276* Option to request multiple responses when using command-prompt.
2277* Improved environment handling.
2278* Combine wrapped lines when pasting.
2279* Option to override terminal settings (terminal-overrides).
2280* Use the full range of ACS characters for drawing pane separator lines.
2281* Customisable mode keys.
2282* Status line colour options, with embedded colours in status-left/right, and
2283  an option to centre the window list.
2284* Much improved layouts, including both horizontal and vertical splitting.
2285* Optional visual bell, activity and content indications.
2286* Set the utf8 and status-utf8 options when the server is started with -u.
2287* display-message command to show a message in the status line, by default some
2288  information about the current window.
2289* Improved current process detection on NetBSD.
2290* unlink-window -k is now the same as kill-window.
2291* attach-session now works from inside tmux.
2292* A system-wide configuration file, /etc/tmux.conf.
2293* A number of new commands in copy mode, including searching.
2294* Panes are now specified using the target (-t) notation.
2295* -t now accepts fnmatch(3) patterns and looks for prefixes.
2296* Translate \r into \n when pasting.
2297* Support for binding commands to keys without the prefix key
2298* Support for alternate screen (terminfo smcup/rmcup).
2299* Maintain data that goes off screen after reducing the window size, so it can
2300  be restored when the size is increased again.
2301* New if-shell command to test a shell command before running a tmux command.
2302* tmux now works as the shell.
2303* Man page reorganisation.
2304* Many minor additions, much code tidying and several bug fixes.
2305
2306CHANGES FROM 0.8 TO 0.9, 01 July 2009
2307
2308* Major changes to build infrastructure: cleanup of makefiles and addition
2309  of a configure script.
2310* monitor-content window option to monitor a window for a specific fnmatch(3)
2311  pattern. The find-window command also now accepts fnmatch(3) patterns.
2312* previous-layout and select-layout commands, and a main-horizontal layout.
2313* Recreate the server socket on SIGUSR1.
2314* clear-history command.
2315* Use ACS line drawing characters for pane separator lines.
2316* UTF-8 improvements, and code to detect UTF-8 support by looking at
2317  environment variables.
2318* The resize-pane-up and resize-pane-down commands are now merged together
2319  into a new resize-pane command with -U and -D flags.
2320* confirm-before command to request a yes/no answer before executing dangerous
2321  commands.
2322* Status line bug fixes, support for UTF-8 (status-utf8 option), and a key to
2323  paste from the paste buffer.
2324* Support for some additional escape sequences and terminal features, including
2325  better support for insert mode and tab stops.
2326* Improved window resizing behaviour, modelled after xterm.
2327* Some code reduction and a number of miscellaneous bug fixes.
2328
2329================================================================================
2330
2331On 01 June 2009, tmux was imported into the OpenBSD base system. From this date
2332onward changes are logged as part of the normal CVS commit message to either
2333OpenBSD or SourceForge CVS. This file will be updated to contain a summary of
2334major changes with each release, and to mention important configuration or
2335command syntax changes during development.
2336
2337The list of older changes is below.
2338
2339================================================================================
2340
234121 May 2009
2342
2343* stat(2) files before trying to load them to avoid problems, for example
2344  with "source-file /dev/zero".
2345
234619 May 2009
2347
2348* Try to guess if the window is UTF-8 by outputting a three-byte UTF-8 wide
2349  character and seeing how much the cursor moves. Currently tries to figure out
2350  if this works by some stupid checks on the terminal, these need to be
2351  rethought. Also might be better using a width 1 character rather than width 2.
2352* If LANG contains "UTF-8", assume the terminal supports UTF-8, on the grounds
2353  that anyone who configures it probably wants UTF-8. Not certain if this is
2354  a perfect idea but let's see if it causes any problems.
2355* New window option: monitor-content. Searches for a string in a window and if
2356  it matches, highlight the status line.
2357
235818 May 2009
2359
2360* main-horizontal layout and main-pane-height option to match vertical.
2361* New window option main-pane-width to set the width of the large left pane with
2362  main-vertical (was left-vertical) layout.
2363* Lots of layout cleanup. manual layout is now manual-vertical.
2364
236516 May 2009
2366
2367* select-layout command and a few default key bindings (M-0, M-1, M-2, M-9) to
2368  select layouts.
2369* Recreate server socket on SIGUSR1, per SF feature request 2792533.
2370
237114 May 2009
2372
2373* Keys in status line (p in vi mode, M-y in emacs) to paste the first line
2374  of the upper paste buffer. Suggested by Dan Colish.
2375* clear-history command to clear a pane's history.
2376* Don't force wrapping with \n when asked, let the cursor code figure it out.
2377  Should fix terminals which use this to detect line breaks.
2378* Major cleanup and restructuring of build infrastructure. Still separate files
2379  for GNU and BSD make, but they are now hugely simplified at the expense of
2380  adding a configure script which must be run before make. Now build and
2381  install with:
2382
2383	$ ./configure && make && sudo make install
2384
238504 May 2009
2386
2387* Use ACS line drawing characters for pane separator lines.
2388
238930 April 2009
2390
2391* Support command sequences without a space before the semicolon, for example
2392  "neww; neww" now works as well as "neww ; neww". "neww;neww" is still an
2393  error.
2394* previous-layout command.
2395* Display the layout name in window lists.
2396* Merge resize-pane-up and resize-pane-down into resize-pane with -U and -D
2397  flags.
2398
239929 April 2009
2400
2401* Get rid of compat/vis.* - only one function was used which is easily
2402  replaced,and less compat code == good.
2403
240427 April 2009
2405
2406* Avoid using the prompt history when the server is locked, and prevent any
2407  input entered from being added to the client's prompt history.
2408* New command, confirm-before (alias confirm), which asks for confirmation
2409  before executing a command. Bound "&" and "x" by default to confirm-before
2410  "kill-window" and confirm-before "kill-pane", respectively.
2411
241223 April 2009
2413
2414* Support NEL, yet another way of making newline. Fixes the output from some
2415  Gentoo packaging thing. Reported by someone on SF then logs that allowed a
2416  fix sent by tcunha.
2417* Use the xenl terminfo flag to detect early-wrap terminals like the FreeBSD
2418  console. Many thanks for a very informative email from Christian Weisgerber.
2419
242021 April 2009
2421
2422* tmux 0.8 released.
2423
242417 April 2009
2425
2426* Remove the right number of characters from the buffer when escape then
2427  a cursor key (or other key prefixed by \033) is pressed. Reported by
2428  Stuart Henderson.
2429
243003 April 2009
2431
2432* rotate-window command. -U flag (default) for up, -D flag for down.
2433
243402 April 2009
2435
2436* Change scroll/pane redraws to only redraw the single pane affected rather
2437  than the entire window.
2438* If redrawing the region would mean redrawing > half the pane, just schedule
2439  to redraw the entire window. Also add a flag to skip updating the window any
2440  further if it is scheduled to be redrawn. This has the effect of batching
2441  multiple redraws together.
2442
244301 April 2009
2444
2445* Basic horizontal splitting and layout management. Still some redraw and other
2446  issues - particularly, don't mix with manual pane resizing, be careful when
2447  viewing from multiple clients and don't expect shell windows to redraw very
2448  well after the layout is changed; generally cycling the layout a few times
2449  will fix most problems. Getting this in for testing while I think about how
2450  to deal with manual mode.
2451
2452  Split window as normal and cycle the layouts with C-b space. Some of the
2453  layouts will work better when swap-pane comes along.
2454
245531 March 2009
2456
2457* AIX port, thanks to cmihai for access to a box. Only tested on 6.1 with xlc
2458  10.1 (make sure CC is set). Needs GNU make and probably ncurses (didn't try
2459  plain curses). Also won't build with DEBUG, so comment the FDEBUG=1 line in
2460  GNUmakefile.
2461* Draw a vertical line on the right when the window size is less than the
2462  terminal size. This is partly to shake out any horizontal limit bugs on the
2463  way to horizontal splitting/pane tiling. Currently a bit slow since it has to
2464  do a lot of redrawing but hopefully that will improve as I get some better
2465  ideas for how to do it.
2466* Fix remaining problems with copy and paste and UTF-8.
2467
246828 March 2009
2469
2470* Better UTF-8 support, including combined characters. Unicode data is now
2471  stored as UTF-8 in a separate array, the code does a lookup into this every
2472  time it gets to a UTF-8 cell. Zero width characters are just appended onto
2473  the UTF-8 data for the previous cell. This also means that almost no bytes
2474  extra are wasted non-Unicode data (yay).
2475
2476  Still some oddities, such as copy mode skips over wide characters in a
2477  strange way, and the code could do with some tidying.
2478* Key repeating is now a property of the key binding not of the command.
2479  Repeat is turned on when the key is bound with the -r flag to bind-key.
2480  next/previous-window no longer repeat by default as it turned out to annoy
2481  me.
2482
248327 March 2009
2484
2485* Clear using ED when redrawing the screen. I foolishly assumed using spaces
2486  would be equivalent and terminals would pick up on this, but apparently not.
2487  This fixes copy and paste in xterm/rxvt.
2488* Sockets in /tmp are now created in a subdirectory named, tmux-UID, eg
2489  tmux-1000. The default socket is thus /tmp/tmux-UID/default. To start a
2490  separate server, the new -L command line option should be used: this creates
2491  a socket in the same directory with a different name ("-L main" will create
2492  socket called "main"). -S should only be used to place the socket outside
2493  /tmp. This makes sockets a little more secure and a bit more convenient to
2494  use multiple servers.
2495
249621 March 2009
2497
2498* New session flag "set-remain-on-exit" to set remain-on-exit flag for new
2499  windows created in that session (like "remain-by-default" used to do). Not
2500  perfectly happy about this, but until I can think of a good way to introduce
2501  it generically (maybe a set of options in the session) this will do. Fixes
2502  SF request 2527847.
2503
250407 March 2009
2505
2506* Support for 88 colour terminals.
2507* break-pane command to create a new window using an existing pane.
2508
250902 March 2009
2510
2511* Make escape key timer work properly so escape+key can be used without
2512  lightning fast key presses.
2513
251413 February 2009
2515
2516* Redo mode keys slightly more cleanly and apply them to command prompt
2517  editing. vi or emacs mode is controlled by the session option status-keys.
2518
251912 February 2009
2520
2521* Looking up argv[0] is expensive, so just use p_comm for the window name which
2522  is good enough. Also increase name update time to 500 ms.
2523
252411 February 2009
2525
2526* Only use ri when actually at the top of the screen; just move the cursor up
2527  otherwise.
2528* FreeBSD's console wraps lines at $COLUMNS - 1 rather than $COLUMNS (the
2529  cursor can never be beyond $COLUMNS - 1) and does not appear to support
2530  changing this behaviour, or any of the obvious possibilities (turning off
2531  right margin wrapping, insert mode). This is irritating, most notably because
2532  it impossible to write to the very bottom-right of the screen without
2533  scrolling. To work around this, if built on FreeBSD and run with a "cons"
2534  $TERM, the bottom-right cell on the screen is omitted.
2535* Emulate scroll regions (slowly) to support the few terminals which don't have
2536  it (some of which don't really have any excuse).
2537
253810 February 2009
2539
2540* No longer redraw the status line every status-interval unless it has actually
2541  changed.
2542
254308 February 2009
2544
2545* Don't treat empty arguments ("") differently when parsing configuration
2546  file/command prompt rather than command line.
2547* tmux 0.7 released.
2548
254903 February 2009
2550
2551* New command, copy-buffer (alias copyb), to copy a session paste buffer to
2552  another session.
2553
255401 February 2009
2555
2556* The character pair #(command) may now contain (escaped) right parenthesis.
2557
255830 January 2009
2559
2560* . now bound to "command-prompt 'move-window %%'" by default, from joshe.
2561
256229 January 2009
2563
2564* Window options to set status line fg, bg and attributes for a single
2565  window. Options are: window-status-fg, window-status-bg,
2566  window-status-attr. Set to "default" to use the session status colours.
2567
2568  This allows quite neat things like:
2569
2570	$ cat ~/bin/xssh
2571	#!/bin/sh
2572
2573	if [ ! -z "$TMUX" ]; then
2574	case "$1" in
2575    	natalya)
2576	        tmux setw window-status-fg red >/dev/null
2577		;;
2578	natasha)
2579        	tmux setw window-status-fg yellow >/dev/null
2580		;;
2581	esac
2582	fi
2583	ssh "$@"
2584	[ ! -z "$TMUX" ] && tmux setw -u window-status-fg >/dev/null
2585	$ alias ssh="~/bin/xssh"
2586
2587* Support #(command) in status-left, and status-right, which is displayed as
2588  the first line of command's output (e.g. set -g status-right
2589  "#(whoami)@#(hostname -s)"). Commands with )s aren't supported.
2590
259128 January 2009
2592
2593* Support mouse in copy mode to move cursor. Can't do anything else at the
2594  moment until other mouse modes are handled.
2595* Better support for at least the most common variant of mouse input: parse it
2596  and adjust for different panes. Also support mouse in window/session choice
2597  mode.
2598
259927 January 2009
2600
2601* Bring back the fancy window titles with session/window names: it is easy to
2602  work around problems with elinks (see FAQ).
2603* -u flag to scroll-mode and copy-mode to start scrolled one page
2604  up. scroll-mode -u is bound to prefix,page-up (ppage) by default.
2605* Allow status, mode and message attributes to be changed by three new options:
2606  status-attr, mode-attr, message-attr. A comma-separated list is accepted
2607  containing: bright, dim, underscore, blink, reverse, hidden, italics, for
2608  example:
2609
2610	set -g status-attr bright,blink
2611
2612  From Josh Elsasser, thanks!
2613
261426 January 2009
2615
2616* Be more clever about picking the right process to create the window name.
2617* Don't balls up the terminal on UTF-8 combined characters. Don't support them
2618  properly either - they are just discarded for the moment.
2619
262025 January 2009
2621
2622* load-buffer command
2623
262423 January 2009
2625
2626* Use reverse colours rather than swapping fg and bg for message, mode and
2627  status line. This makes these usable on black and white terminals.
2628* Better error messages when creating a session or window fails.
2629* Oops. Return non-zero on error. Reported by Will Maier.
2630
263121 January 2009
2632
2633* Handle SIGTERM (and kill-server which uses it), a bit more neatly - tidy
2634  up properly and print a nicer message. Same effect though :-).
2635* new-window now supports -k to kill target window if it exists.
2636* Bring back split-window -p and -l options to specify the height a percentage
2637  or as a number of lines.
2638* Make window and session choice modes allow you to choose items in vi keys
2639  mode (doh!). As a side-effect, this makes enter copy selection (as well
2640  as C-w/M-w) when using emacs keys in copy mode. Reported by merdely.
2641
264220 January 2009
2643
2644* Darwin support for automatic-rename from joshe; Darwin doesn't seem to have
2645  a sane method of getting argv[0] and searching for the precise insane way
2646  is too frustrating, so this just uses the executable name.
2647* Try to change the window title to match the command running it in. This is
2648  done by reading argv[0] from the process group leader of the group that owns
2649  the tty (tcgetpgrp()). This can't be done portably so some OS-dependent code
2650  is introduced (ugh); OpenBSD, FreeBSD and Linux are supported at the moment.
2651
2652  A new window flag, automatic-rename, is available: if this is set to off, the
2653  window name is not changed. Specifying a name with the new-window,
2654  new-session or rename-window commands will automatically set this flag to off
2655  for the window in question. To disable it entirely set the option to off
2656  globally (setw -g automatic-rename off).
2657
265819 January 2009
2659
2660* Fix various stupid issues when the status line is turned off. Grr.
2661* Use reverse attributes for clock and cursor, otherwise they do not
2662  appear on black and white terminals.
2663* An error in a command sequence now stops execution of that sequence.
2664  Internally, each command code now passes a return code back rather than
2665  talking to the calling client (if any) directly.
2666* attach-session now tries to start the server if it isn't already started - if
2667  no sessions are created in .tmux.conf this will cause an error.
2668* Clean up starting server by making initial client get a special socketpair.
2669
267018 January 2009
2671
2672* Unbreak UTF-8.
2673* -a flag to next-window and previous-window to select the next or previous
2674  window with activity or bell. Bound to M-n and M-p.
2675* find-window command to search window names, titles and visible content (but
2676  not history) for a string. If only one is found, the window is selected
2677  otherwise a choice list is shown. This (as with the other choice commands)
2678  only works from a key. Bound to "f" by default.
2679* Cleaned up command printing code, also enclose arguments with spaces in "s.
2680* Added command sequences. These are entered by separating each argument by a ;
2681  argument (spaces on both sides), for example:
2682
2683	lsk ; lsc
2684
2685  To use a literal ; as the argument prefix it with \, for example:
2686
2687	bind x lsk \; lsc
2688
2689  Commands are executed from left to right. Also note that command sequences do
2690  not support repeat-time repetition unless all commands making up the sequence
2691  support it.
2692* suspend-client command to suspend a client. Don't try to background it
2693  though...
2694* Mark attached sessions in sessions lists. Suggested by Simon Kuhnle.
2695
269617 January 2009
2697
2698* tmux 0.6 released.
2699
270015 January 2009
2701
2702* Support #H for hostname and #S for session name in status-left/right.
2703* Two new commands, choose-window and choose-session which work only when bound
2704  to a key and allow the window or session to be selected from a list. These
2705  are now bound to "w" and "s" instead of the list commands.
2706
270714 January 2009
2708
2709* Rework the prefix-time stuff. The option is now called repeat-time and
2710  defaults to 500 ms. It only applies to a small subset of commands, currently:
2711  up-pane, down-pane, next-window, previous-window, resize-pane-up,
2712  resize-pane-down. These are the commands for which it is obviously useful,
2713  having it for everything else was just bloody annoying.
2714* The alt-up and alt-down keys now resize a pane by five lines at a time.
2715* switch-pane is now select-pane and requires -p to select a pane. The
2716  "o" key binding is changed to down-pane.
2717* up-pane and down-pane commands, bound to arrow up and down by default.
2718* Multiple vertical window splitting. Minimum pane size is four lines, an
2719  (unhelpful) error will be shown if attempting to split a window with less
2720  that eight lines. If the window is resized, as many panes are shown as can
2721  fit without reducing them below four lines. There is (currently!) not a way
2722  to show a hidden pane without making the window larger.
2723
2724  Note the -p and -l options to split-window are now gone, these may reappear
2725  once I think them through again.
2726* Server locking on inactivity (lock-after-time) is now disabled by default.
2727
272813 January 2009
2729
2730* kill-pane command.
2731
273212 January 2009
2733
2734* command-prompt now accepts a single argument, a template string. Any
2735  occurrences of %% in this string are replaced by whatever is entered at the
2736  prompt and the result is executed as a command. This allows things like (now
2737  bound by default):
2738
2739  	 bind , command-prompt "rename-window %%"
2740
2741  Or my favourite:
2742
2743         bind x command-prompt "split-window 'man %%'"
2744
2745* Option to set prefix time, allowing multiple commands to be entered without
2746  pressing the prefix key again, so long as they each typed within this time of
2747  each other.
2748* Yet more hacks for key handling. Think it is just about working now.
2749* Two commands, resize-pane-up and resize-pane-down to resize a pane.
2750* Make the window pane code handle panes of different sizes, and add a -l
2751  and -p arguments to split-window to specify the new window size in lines
2752  or as a percentage.
2753
275411 January 2009
2755
2756* Vertical window splitting. Currently can only split a window into two panes.
2757  New split-window command splits (bound to ") and switch-pane command (bound to
2758  o) switches between panes.
2759
2760  close-pane, swap-pane commands are to follow. Also to come are pane resizing,
2761  >2 panes, the ability to break a pane out to a full window and vice versa and
2762  possibly horizontal splitting.
2763
2764  Panes are subelements of windows rather than being windows in their own
2765  right. I tried to make them windows (so the splitting was at the session or
2766  client level) but this rapidly became very complex and invasive. So in the
2767  interests of having something working, I just made it so each window can have
2768  two child processes instead of one (and it still took me 12 hours straight
2769  coding). Now the concept is proven and much of the support code is there,
2770  this may change in future if more flexibility is needed.
2771* save-buffer command, from Tiago Cunha.
2772
277310 January 2009
2774
2775* New option, lock-after-time. If there is no activity in the period specified
2776  by this option (in seconds), tmux will lock the server. Default is 1800 (30
2777  minutes), set to 0 to disable.
2778* Server locking. Two new commands: set-password to set a password (a
2779  preencrypted password may be specified with -c); and lock-server to lock the
2780  server until the password is entered. Also an additional command line flag,
2781  -U, to unlock from the shell. The default password is blank (any password
2782  accepted). If specifying an encrypted password from encrypt(1) in .tmux.conf
2783  with -c, don't forget to enclose it in single-quotes (') to prevent shell
2784  variable expansion.
2785* If a window is created from the command line, tmux will now use the same
2786  current working directory for the new process. A new default-path option to
2787  sets the working directory for processes created from keys or interactively
2788  from the prompt.
2789* New mode to display a large clock. Entered with clock-mode command (bound to
2790  C-b t by default); two window options: clock-mode-colour and clock-mode-style
2791  (12 or 24). This will probably be used as the basis for window locking.
2792* New command, server-info, to show some server information and terminal
2793  details.
2794
279509 January 2009
2796
2797* Stop using ncurses variables and instead build a table of the codes we want
2798  into an array for each terminal type. This makes the code a little more
2799  untidy in places but gets rid of the awful global variables and calling
2800  setterm all the time, and shoves all the ncurses-dependent mess into a single
2801  file, tty-term.c. It also allows overriding single terminal codes, this is
2802  used to fix rxvt on some platforms (where it is missing dch) and in future
2803  may allow user customisation a la vim.
2804* Update key handling code. Simplify, support ctrl properly and add a new
2805  window option (xterm-keys) to output xterm key codes including ctrl and,
2806  if available, alt and shift.
2807
280808 January 2009
2809
2810* If built without DEBUG (the release versions), don't cause a fatal error if
2811  the grid functions notice an input error, just log and ignore the
2812  request. This might mean me getting shouted at less often when bugs kill
2813  long-running sessions, at least in release versions.
2814* Hopefully fix cursor out-of-bounds checking when writing to grid. When I
2815  wrote the code I must have forgotten that the cursor can be one cell off the
2816  right of the screen (yes, I know), so there were number of out-of-bounds/
2817  overflow problems.
2818
281907 January 2009
2820
2821* New flag to set and setw, -u, to unset an option (allowing it to inherit from)
2822  the global options again.
2823* Added more info messages for options changes.
2824* A bit of tidying and reorganisation of options code.
2825
282606 January 2009
2827
2828* Don't crash when backspacing if cursor is off the right of the screen,
2829  reported by David Chisnall.
2830* Complete words at any point inside command in prompt, also use option name
2831  as well as command names.
2832* Per-client prompt history of up to 100 items.
2833* Use a splay tree for key bindings instead of an array. As a side-effect this
2834  sorts them when listed.
2835
283622 December 2008
2837
2838* Use the right keys for home and end.
2839
284020 December 2008
2841
2842* Add vim mode for tmux configuration file to examples/, from Tiago Cunha.
2843
284415 December 2008
2845
2846* New command, source-file (alias source), to load a configuration
2847  file. Written by Tiago Cunha, many thanks.
2848
284913 December 2008
2850
2851* Work around lack of dch. On Linux, the rxvt termcap doesn't have it (it is
2852  lying, but we can't really start disbelieving termcaps...). This is a bit
2853  horrible - I can see no way to do it without pretty much redrawing the whole
2854  line, but it works...
2855
285610 December 2008
2857
2858* glibc's getopt(3) is useless: it is not POSIX compliant without jumping
2859  through non-portable hoops, and the method of resetting it is unclear (the
2860  man page on my system says set optind to 1, but other sources say 0). So,
2861  import OpenBSD's getopt_long.c into compat/ for use on Linux and use the
2862  clearly documented optreset = optind = 1 method. This fixes some strange
2863  issues with command parsing (getting the syntax wrong would prevent any
2864  further commands being parsed).
2865
286606 December 2008
2867
2868* Bring set/setw/show/showw into line with other commands. This means that by
2869  default they now affect the current window (if any); the new -g flag must be
2870  passed to set the global options. This changes the behaviour of set/show and
2871  WILL BREAK CURRENT CONFIGURATIONS.
2872
2873  In summary, whether in the configuration file, the command prompt, or a key
2874  binding, use -g to set a global option, use -t to specify a particular window
2875  or session, or omit both to try and use the current window or session.
2876
2877  This makes set/show a bit of a pain but is the correct behaviour for
2878  setw/showw and is the same as every other command, so we can put up with a
2879  bit of pain for consistency.
2880* Redo window options. They now work in the same way to session options with a
2881  global options set. showw/setw commands now have similar syntax to show/set
2882  (including the ability to use abbreviations).
2883
2884  PLEASE NOTE this includes the following configuration-breaking changes:
2885
2886  - remain-by-default is now GONE, use "setw -g remain-on-exit" to apply the
2887    global window option instead;
2888  - mode-keys is now a window option rather than session - use "setw [-g]
2889    mode-keys" instead of set.
2890
2891  There are also some additions:
2892
2893  - message-fg and message-bg session options to control status line message
2894    colours;
2895  - mode-fg and mode-bg window options to set colours in window modes such as
2896    copy mode.
2897
2898  The options code still a mess and now there is twice as much of it :-(.
2899
290002 December 2008
2901
2902* Add support for including the window title in status-left or status-right
2903  strings by including the character pair "#T". This may be prefixed with
2904  a number to specify a maximum length, for example "#24T" to use at most
2905  24 characters of the title.
2906* Introduce two new options, status-left-length and status-right-length,
2907  control the maximum length of left and right components of the status bar.
2908* elinks (and possibly others) bypass the terminal and talk directly to X to
2909  restore the window title when exiting. tmux can't know about this particular
2910  bit of stupidity so the title ends up strange - the prefix isn't terribly
2911  important and elinks is quite useful so just get rid of it.
2912
291327 November 2008
2914
2915* Tweaks to support Dragonfly.
2916
291717 November 2008
2918
2919* tmux 0.5 released.
2920
292116 November 2008
2922
2923* New window option: "utf8"; this must be on (it is off by default) for UTF-8
2924  to be parsed. The global/session option "utf8-default" controls the setting
2925  for new windows.
2926
2927  This means that by default tmux does not handle UTF-8. To use UTF-8 by
2928  default it is necessary to a) "set utf8-default on" in .tmux.conf b) start
2929  tmux with -u on any terminal which support UTF-8.
2930
2931  It seems a bit unnecessary for this to be a per-window option but that is
2932  the easiest way to do it, and it can't do any harm...
2933* Enable default colours if op contains \033[39;49m, based on a report from
2934  fulvio ciriaco.
2935
293612 November 2008
2937
2938* Keep stack of last windows rather than just most recent; based on a diff from
2939  joshe.
2940
294104 November 2008
2942
2943* Don't try to redraw status line when showing a prompt or message; if it does,
2944  the status timer is never reset so it redraws on every loop. Spotted by
2945  joshe.
2946
294709 October 2008
2948
2949* Translate 256 colours into 16 if 256 is not available, same as screen does.
2950* Better support for OSC command (only to set window title now), and also
2951  support using APC for the same purpose (some Linux default shell profiles do
2952  this).
2953
295425 September 2008
2955
2956* Large internal rewrite to better support 256 colours and UTF-8. Screen data
2957  is now stored as single two-way array of structures rather than as multiple
2958  separate arrays. Also simplified a lot of code.
2959
2960  Only external changes are three new flags, -2, -d and -u, which force tmux to
2961  assume the terminal supports 256 colours, default colours (useful for
2962  xterm-256color which lacks the AX flag), or UTF-8 respectively.
2963
296410 September 2008
2965
2966* Split off colour conversion code from screen code.
2967
296809 September 2008
2969
2970* Initial UTF-8 support. A bit ugly and with a limit of 4096 UTF-8
2971  characters per window.
2972
297308 September 2008
2974
2975* 256 colour support. tmux attempts to autodetect the terminal by looking
2976  both at what ncurses reports (usually wrong for xterm) and checking if
2977  the TERM contains "256col". For xterm TERM=xterm-256color is needed (as
2978  well as a build that support 256 colours); this seems to work for rxvt
2979  as well. On non-256 colour terminals, high colours are translated to white
2980  foreground and black background.
2981
298228 August 2008
2983
2984* Support OS X/Darwin thanks to bsd-poll.c from OpenSSH. Also convert
2985  from clock_gettime(2) to gettimeofday(2) as OS X doesn't support the
2986  former; microsecond accuracy will have to be sufficient ;-).
2987
298807 August 2008
2989
2990* Lose some unused/useless wrapper functions.
2991
299225 July 2008
2993
2994* Shell variables may now be defined and used in configuration file. Define
2995  variables with:
2996
2997	VAR=1
2998
2999  And use with:
3000
3001        renamew ${VAR}
3002	renamew "x${VAR}x"
3003
3004 Also some other fixes to make, for example, "abc""abc" work similarly to
3005 the shell.
3006
300724 July 2008
3008
3009* Finally lose inconsistently-used SCREEN_DEF* defines.
3010* If cursor mode is on, switch the arrow keys from \033[A to \033OA.
3011* Support the numeric keypad in both application and numbers mode. This is
3012  different from screen which always keeps it in application mode.
3013
301419 July 2008
3015
3016* Unbreak "set status" - tmux thought it was ambiguous, reported by rivo nurges.
3017
301802 July 2008
3019
3020* Split vi and emacs mode keys into two tables and add an option (mode-keys)
3021  to select between them. Default is emacs, use,
3022
3023     tmux set mode-keys vi
3024
3025  to change to vi.
3026
3027  vi mode uses space to start selection, enter to copy selection and escape
3028  to clear selection.
3029
303001 July 2008
3031
3032* Protocol versioning. Clients which identify as a different version from the
3033  server will be rejected.
3034* tmux 0.4 released.
3035
303629 June 2008
3037
3038* Zombie windows. These are not closed when the child process dies. May be
3039  set for a window with the new "remain-on-exit" option; the default setting
3040  of this flag for new windows may be set with the "remain-by-default" session
3041  option.
3042
3043  A window may be restarted with the respawn-window command:
3044
3045  	respawn-window [-k] [command]
3046
3047  If -k is given, any existing process running in the window is killed;
3048  if command is omitted, the same command as when the window was first
3049  created is used.
3050
305127 June 2008
3052
3053* Handle nonexistent session or client to -t properly.
3054
305525 June 2008
3056
3057* select-prompt command to allow a window to be selected at a prompt. Only
3058  windows in the current session may be selected. Bound to ' by default.
3059  Suggested by merdely.
3060* move-window command. Requested by merdely.
3061* Support binding alt keys (prefixed with M-). Change default to use
3062  C- for ctrl keys (^ is still accepted as an alternative).
3063* Slim down default key bindings: support lowercase only.
3064* Handle escaped keys properly (parse eg \033b into a single key code) and
3065  use this to change copy mode next/previous work to M-f and M-b to match
3066  emacs.
3067
306824 June 2008
3069
3070* Next word (C-n/w) and previous word (C-b/b) in copy mode.
3071
307223 June 2008
3073
3074* list-commands command (alias lscm).
3075* Split information about options into a table and use it to parse options
3076  on input (allowing abbreviations) and to print them with show-options
3077  (meaning that bell-action gets a proper string). This turned out a bit ugly
3078  though :-/.
3079
308022 June 2008
3081
3082* Do not translate black and white into default if the terminal supports
3083  default colours. This was nice to force programs which didn't use default
3084  colours to be properly transparent in rxvt/aterm windows with a background
3085  image, but it causes trouble if someone redefines the default foreground and
3086  background (to have black on white or something).
3087
308821 June 2008
3089
3090* Naive tab completion in the command prompt. This only completes command
3091  names if a) they are at the start of the text b) the cursor is at
3092  the end of the text c) the text contains no spaces.
3093* Only attempt to set the title where TERM looks like an xterm (contains
3094  "xterm", "rxvt" or is "screen"). I hate this but I don't see a better way:
3095  setting the title actually kills some other terminals pretty much dead.
3096* Strip padding out of terminfo(5) strings. Currently the padding is just
3097  ignored, this may need to be altered if there are any software terminals
3098  out there that actually need it.
3099
310020 June 2008
3101
3102* buffer-limit option to set maximum size of buffer stack. Default is 9.
3103* Initial buffer improvements. Each session has a stack of buffers and each
3104  buffer command takes a -b option to manipulate items on the stack. If -b
3105  is omitted, the top entry is used. The following commands are currently
3106  available:
3107
3108	set-buffer [-b index] [-t target-session] string
3109	paste-buffer [-d] [-b index] [-t target-window]
3110	delete-buffer [-b index] [-t target-session]
3111	show-buffers [-t target-session]
3112	show-buffer [-b index] [-t target-session]
3113
3114  -d to paste-buffer deletes the buffer after pasting it.
3115* New option, display-time, sets the time status line messages stay on screen
3116  (unless a key is pressed). Set in milliseconds, default is 750 (0.75 seconds).
3117  The timer is only checked every 100 ms or so.
3118
311919 June 2008
3120
3121* Use "status" consistently for status line option, and prefix for "prefix" key
3122  option.
3123* Allow commands to be entered at a prompt. This is triggered with the
3124  command-prompt command, bound to : by default.
3125* Show status messages properly, without blocking the server.
3126
312718 June 2008
3128
3129* New option, set-titles. On by default, this attempts to set the window title
3130  using the \e]2;...\007 xterm code.
3131
3132  Note that elinks requires the STY environment variable (used by screen) to be
3133  set before it will set the window title. So, if you want window titles set by
3134  elinks, set STY before running it (any value will do). I can't do this for all
3135  windows since setting it to an invalid value breaks screen.
3136* Show arrows at either end of status line when scrolled if more windows
3137  exist. Highlight the arrow if a hidden window has activity or bell.
3138* Scroll the status line to show the current window if necessary. Also handle
3139  windows smaller than needed better (show a blank status line instead of
3140  hanging or crashing).
3141
314217 June 2008
3143
3144* tmux 0.3 released.
3145
314616 June 2008
3147
3148* Add some information messages when window options are changed, suggested by
3149  Mike Erdely. Also add a -q command-line option to suppress them.
3150* show-window-options (showw) command.
3151
315215 June 2008
3153
3154* show-options (show) command to show one or all options.
3155
315614 June 2008
3157
3158* New window options: force-width and force-height. This will force a window
3159  to an arbitrary width and height (0 for the default unlimited). This is
3160  neat for emacs which doesn't have a sensible way to force hard wrapping at 80
3161  columns. Also, don't try to be clever and use clr_eol when redrawing the
3162  whole screen, it causes trouble since the redraw functions are used to draw
3163  the blank areas too.
3164* Clear the blank area below windows properly when they are smaller than client,
3165  also add an indicator line to show the vertical limit.
3166* Don't die on empty strings in config file, reported by Will Maier.
3167
316808 June 2008
3169
3170* Set socket mode +x if any sessions are attached and -x if not.
3171
317207 June 2008
3173
3174* Make status-interval actually changeable.
3175
317606 June 2008
3177
3178* New window option: aggressive-resize. Normally, windows are resized to the
3179  size of the smallest attached session to which they are linked. This means a
3180  window only changes size when sessions are detached or attached, or they are
3181  linked or unlinked from a session. This flag changes a window to be the size
3182  of the smallest attached session for which it is the current window - it is
3183  resized every time a session changes to it or away from it. This is nice for
3184  things that handle SIGWINCH well (like irssi) and bad for things like shells.
3185* The server now exits when no sessions remain.
3186* Fix bug with inserting characters with TERM=xterm-color.
3187
318805 June 2008
3189
3190* Completely reorganise command parsing. Much more common code in cmd-generic.c
3191  and a new way of specifying windows, clients or sessions. Now, most commands
3192  take a -t argument, which specifies a client, a session, or a window target.
3193  Clients and sessions are given alone (sessions are fnmatch(3)d and
3194  clients currently not), windows are give by (client|session):index. For
3195  example, if a user is in session "1" window 0 on /dev/ttypi, these should all
3196  be equivalent:
3197
3198	tmux renamew newname			(current session and window)
3199	tmux renamew -t: newname		(current session and window)
3200	tmux renamew -t:0 newname		(current session, window 0)
3201	tmux renamew -t0 newname		(current session, window 0)
3202	tmux renamew -t1:0 newname		(session 1, window 0)
3203	tmux renamew -t1: newname		(session 1's current window)
3204	tmux renamew -t/dev/ttypi newname	(client /dev/ttypi's current
3205						 session and window)
3206	tmux renamew -t/dev/ttypi: newname	(client /dev/ttypi's current
3207						 session and window)
3208	tmux renamew -t/dev/ttypi:0 newname	(client /dev/ttypi's current
3209						 session, window 0)
3210
3211  This does have some downsides, for example, having to use -t on selectw,
3212
3213	tmux selectw -t7
3214
3215  is annoying. But then using non-flagged arguments would mean renaming the
3216  current window would need to be something like:
3217
3218	tmux renamew : newname
3219
3220  It might be better not to try and be so consistent; comments to the usual
3221  address ;-).
3222* Infrastructure for printing arguments in list-keys output. Easy ones only for
3223  now.
3224
322504 June 2008
3226
3227* Add some vi(1) key bindings in copy mode, and support binding ^[, ^\, ^]
3228  ^^ and ^_. Both from/prompted by Will Maier.
3229* setw monitor-activity and set status without arguments now toggle the current
3230  value; suggested by merdely.
3231* New command set-window-option (alias setw) to set the single current window
3232  option: monitor-activity to determine whether window activity is shown in
3233  the status bar for that window (default off).
3234* Change so active/bell windows are inverted in status line.
3235* Activity monitoring - window with activity are marked in status line. No
3236  way to disable this/filter windows yet.
3237* Brought select-window command into line with everything else; it now uses
3238  -i for the window index.
3239* Strings to display on the left and right of the status bar may now be set
3240  with the status-left and status-right options. These are passed through
3241  strftime(3) before being displayed. The status bar is automatically updated
3242  at an interval set by the status-interval option. The default is to display
3243  nothing on the left and the date and time on the left; the default update
3244  interval is 15 seconds.
3245
324603 June 2008
3247
3248* Per session options. Setting options without specifying a session sets the
3249  global options as normal (global options are inherited by all sessions);
3250  passing -c or -s will set the option only for that session.
3251* Because a client has a session attached, any command needing a session can
3252  take a client and use its session. So, anything that used to accept -s now
3253  accepts -c as well.
3254* -s to specify session name now supports fnmatch(3) wildcards; if multiple
3255  sessions are found, or if no -s is specified, the most newly created is used.
3256* If no command is specified, assume new-session. As a byproduct, clean up
3257  command default values into separate init functions.
3258* kill-server command.
3259
326002 June 2008
3261
3262* New command, start-server (alias "start"), to start the tmux server and do
3263  nothing else. This is good if you have a configuration file which creates
3264  windows or sessions (like me): in that case, starting the server the first
3265  time tmux new is run is bad since it creates a new session and window (as
3266  it is supposed to - starting the server is a side-effect).
3267
3268  Instead, I have a little script which does the equivalent of:
3269
3270  	tmux has -s0 2>/dev/null || tmux start
3271  	tmux attach -d -s0
3272
3273  And I use it to start the server if necessary and attach to my primary
3274  session.
3275* Basic configuration file in ~/.tmux.conf or specified with -f. This is file
3276  contains a set of tmux commands that are run the first time the server is
3277  started. The configuration commands are executed before any others, so
3278  if you have a configuration file that contains:
3279
3280	new -d
3281	neww -s0
3282
3283  And you do the following without an existing server running:
3284
3285	tmux new
3286
3287  You will end up with two sessions, session 0 with two windows (created by
3288  the configuration file) and your client attached to session 1 with one
3289  window (created by the command-line command). I'm not completely happy with
3290  this, it seems a little non-obvious, but I haven't yet decided what to do
3291  about it.
3292
3293  There is no environment variable handling or other special stuff yet.
3294
3295  In the future, it might be nice to be able to have per-session configuration
3296  settings, probably by having conditionals in the file (so you could, for
3297  example, have commands to define a particular window layout that would only
3298  be invoked if you called tmux new -smysession and mysession did not already
3299  exist).
3300* BIG CHANGE: -s and -c to specify session name and client name are now passed
3301  after the command rather than before it. So, for example:
3302
3303	tmux -s0 neww
3304
3305  Becomes:
3306
3307	tmux neww -s0
3308
3309  This is to allow them to be used in the (forthcoming) configuration file
3310  THIS WILL BREAK ANY CURRENT SCRIPTS OR ALIASES USING -s OR -c.
3311
331201 June 2008
3313
3314* Bug fix: don't die if -k passed to link-window and the destination doesn't
3315  exist.
3316* New command, send-keys, will send a set of keys to a window.
3317
331831 May 2008
3319
3320* Fix so tmux doesn't hang if the initial window fails for some reason. This
3321  was highlighted by problems on Darwin, thanks to Elias Pipping for the report
3322  and access to a test account. (tmux still won't work on Darwin since its
3323  poll(2) is broken.)
3324
332502 January 2008
3326
3327* Don't attempt to reset the tty on exit if it has been closed externally.
3328
332906 December 2007
3330
3331* Restore checks for required termcap entries and add a few more obvious
3332  emulations.
3333* Another major reorganisation, this time of screen handling. A new set of
3334  functions, screen_write_*, are now used to write to a screen and a tty
3335  simultaneously. These are used by the input parser to update the base
3336  window screen and also by the different modes which now interpose their own
3337  screen.
3338
333930 November 2007
3340
3341* Support \ek...\e\ to set window name.
3342
334327 November 2007
3344
3345* Enable/disable mouse when asked, if terminal claims to support it. Mouse
3346  sequences are just passed through unaltered for the moment.
3347* Big internal reorganisation. Rather than leaving control of the tty solely in
3348  the client and piping all data through a socket to it, change so that the
3349  server opens the tty again and reads and writes to it directly. This avoids
3350  a lot of buffering and copying. Also reorganise the redrawing stuff so that
3351  everything goes through screen_draw_* - this makes the code simpler, but
3352  still needs broken up more, and all the ways of writing to screens should be
3353  more consistent.
3354
335526 November 2007
3356
3357* Rather than shifting up one line at a time once the history is full,
3358  shift by 10% of the history each time. This is faster.
3359* Add ^A and ^E to copy mode to move to start-of-line/end-of-line.
3360
336124 November 2007
3362
3363* Support for alt charset mode (VT100 graphics characters).
3364
336523 November 2007
3366
3367* Mostly complete copy & paste. Copy mode entered with C-b [ (copy-mode
3368  command). In copy mode, arrow keys/page up/page down/hjkl/C-u/C-f navigate,
3369  space or C-space starts selection, and enter or C-w copies and (important!)
3370  exits copy mode. C-b ] (paste-buffer) pastes into current window. No
3371  extra utility keys (bol/eol/clear selection/etc), only one single buffer,
3372  and no buffer manipulation commands (clear/view/etc) yet. The code is also
3373  fugly :-(.
3374* history-limit option to set maximum history. Does not apply retroactively to
3375  existing windows! Lines take up a variable amount of space, but a reasonable
3376  guess for an 80-column terminal is 250 KB per 1000 lines (of history used,
3377  an empty history takes no space).
3378
337921 November 2007
3380
3381* Create every line as zero length and only expand it as data is written,
3382  rather than creating at full size immediately.
3383* Make command output (eg list-keys) go to a scrollable window similar to
3384  scroll mode.
3385* Redo screen redrawing so it is a) readable b) split into utility functions
3386  that can be used outside screen.c. Use these to make scroll mode only
3387  redraw what it has to which gets rid of irritating flickering status box and
3388  makes it much faster.
3389* Full line width memory and horizontal scrolling in history.
3390* Initial support for scroll history. = to enter scrolling mode, and then
3391  vi keys or up/down/pgup/pgdown to navigate. Q to exit. No horizontal history
3392  yet (need per-line sizes) and a few kinks to be worked out (resizing while in
3393  history mode will probably cause trouble).
3394
339520 November 2007
3396
3397* Fix format string error with "must specify a client" message. Also
3398  sprinkle some printflike tags.
3399* tmux 0.1 released.
3400
340117 November 2007
3402
3403* (nicm) Add -k option to link-window to kill target window if it exists.
3404
340516 November 2007
3406
3407* (nicm) Split in-client display into two columns. This is a hack but not a lot
3408  more so than that bit is already and it helps with lots of keys.
3409* (nicm) switch-client command to switch client between different sessions. This
3410  is pretty cool:
3411
3412	$ tmux bind q switch 0
3413	$ tmux bind w switch 1
3414
3415  Then you can switch between sessions 0 and 1 with a key :-).
3416* (nicm) Accept "-c client-tty" on command line to allow client manipulation
3417  commands, and change detach-/refresh-session to detach-/refresh-client (this
3418  loses the -a behaviour, but at some point -session versions may return, and
3419  -c will allow fnmatch(3)).
3420* (nicm) List available commands on ambiguous command.
3421
342212 November 2007
3423
3424* (nicm) If the terminal supports default colours (AX present), force black
3425  background and white foreground to default. This is useful on transparent
3426  *terms for programs which don't do it themselves (like most(1)).
3427* (nicm) Fill in the rest of the man page.
3428* (nicm) kill-session command.
3429
343009 November 2007
3431
3432* (nicm) C-space is now "^ " not "^@".
3433* (nicm) Support tab (\011).
3434* (nicm) Initial man page outline.
3435* (nicm) -V to show version.
3436* (nicm) rename-session command.
3437
343808 November 2007
3439
3440* (nicm) Check for required terminal capabilities on start.
3441
344231 October 2007
3443
3444* (nicm) Linux port.
3445
344630 October 2007
3447
3448* (nicm) swap-window command. Same as link-window but swaps windows.
3449
345026 October 2007
3451
3452* (nicm) Saving scroll region on \e7 causes problems with ncmpc so I guess
3453  it is not required.
3454* (nicm) unlink-window command.
3455* (nicm) link-window command to link an existing window into another session
3456  (or another index in the same session). Syntax:
3457
3458	tmux -s dstname link-window [-i dstidx] srcname srcidx
3459
3460* (nicm) Redo window data structures. The global array remains, but each per-
3461  session list is now a RB tree of winlink structures. This disassociates the
3462  window index from the array size (allowing arbitrary indexes) which still
3463  allowing windows to have multiple indexes.
3464
346525 October 2007
3466
3467* (nicm) has-session command: checks if session exists.
3468
346924 October 2007
3470
3471* (nicm) Support for \e6n to request cursor position. resize(1) now works.
3472* (nicm) Support for \e7, \e8 save/restore cursor and attribute sequences.
3473  Currently don't save mode (probably should). Also change some cases where
3474  out-of-bound values are ignored to limit them to within range (there are
3475  others than need to be checked too).
3476
347723 October 2007
3478
3479* (nicm) Lift limit on session name passed with -s.
3480* (nicm) Show size in session/window lists.
3481* (nicm) Pass tty up to server when client identifies and add a list-clients
3482  command to list connected clients.
3483
348420 October 2007
3485
3486* (nicm) Add default-command option and change default to be $SHELL rather than
3487  $SHELL -l. Also try to read shell from passwd db if $SHELL isn't present.
3488
348919 October 2007
3490
3491* (nicm) -n on new-session is now -s, and -n is now the initial window name.
3492  This was documented but not implemented :-/.
3493* (nicm) kill-window command, bound to & by default (because it should be hard
3494  to hit accidentally).
3495* (nicm) bell-style option with three choices: "none" completely ignore bell;
3496  "any" pass through a bell in any window to current; "current" ignore bells
3497  except in current window. This applies only to the bell terminal signal,
3498  the status bar always reflects any bells.
3499* (nicm) Refresh session command.
3500
350112 October 2007
3502
3503* (nicm) Add a warning if $TMUX exists on new/attach.
3504* (nicm) send-prefix command. Bound to C-b by default.
3505* (nicm) set status, status-fg, status-bg commands. fg and bg are as a number
3506  from 0 to 8 or a string ("red", "blue", etc). status may be 1/0, on/off,
3507  yes/no.
3508* (nicm) Make status line mark window in yellow on bell.
3509
351004 October 2007
3511
3512* (nicm) -d option to attach to detach all other clients on the same session.
3513* (nicm) Partial resizing support. Still buggy. A C-b S and back sometimes fixes
3514  it when it goes wonky.
3515* (mxey) Added my tmux start script as an example (examples/start-tmux.sh).
3516* (mxey) New sessions can now be given a command for their first window.
3517* (mxey) Fixed usage statement for new-window.
3518* (nicm) attach-session (can't believe I forgot it until now!) and list-windows
3519  commands.
3520* (nicm) rename-window and select-window commands.
3521* (nicm) set-option command (alias set): "tmux set-option prefix ^A".
3522* (nicm) Key binding and unbinding is back.
3523
352403 October 2007
3525
3526* (nicm) {new,next,last,previous}-window.
3527* (nicm) Rewrite command handling so commands are much more generic and the
3528  same commands are used for command line and keys (although most will probably
3529  need to check how they are called). Currently incomplete (only new/detach/ls
3530  implemented). Change: -s is now passed before command again!
3531* (nicm) String number arguments. So you can do: tmux bind ^Q create "blah".
3532* (nicm) Key binding. tmux bind key command [argument] and tmux unbind key.
3533  Key names are in a table in key-string.c, plus A is A, ^A is ctrl-A.
3534  Possible commands are in cmd.c (look at cmd_bind_table).
3535* (nicm) Move command parsing into the client. Also rename some messages and
3536  tidy up a few bits. Lots more tidying up needed :-/.
3537
353802 October 2007
3539
3540* (nicm) Redraw client status lines on rename.
3541* (nicm) Error on ambiguous command.
3542
354301 October 2007
3544
3545* (nicm) Restore window title handling.
3546* (nicm) Simple uncustomisable status line with window list.
3547
354830 September 2007
3549
3550* (nicm) Window info command for debugging, C-b I.
3551
355229 September 2007
3553
3554* (nicm) Deleting/inserting lines should follow scrolling region. Fix.
3555* (nicm) Allow creation of detached sessions: "tmux new-session -d".
3556* (nicm) Permit error messages to be passed back for transient clients like
3557  rename. Also make rename -i work.
3558* (nicm) Pass through bell in any window to current.
3559
356028 September 2007
3561
3562* (nicm) Major rewrite of input parser:
3563	- Lose the old weirdness in favour of a state machine.
3564	- Merge in parsing from screen.c.
3565	- Split key parsing off into a separate file.
3566  This is step one towards hopefully allowing a status line. It requires
3567  that we output data as if the terminal had one line less than it really does -
3568  a serious problem when it comes to things like scrolling. This change
3569  consolidates all the range checking and limiting together which should make
3570  it easier.
3571* (mxey) Added window renaming, like "tmux rename [-s session] [-i index] name"
3572
357327 September 2007
3574
3575* Split "tmux list" into "tmux list-sessions" (ls) and "list-windows" (lsw).
3576* New command session selection:
3577	- if name is specified, look for it and use it if it exists, otherwise
3578	  error
3579	- if no name specified, try the current session from $TMUX
3580	- if $TMUX doesn't exist, and there is only one session, use it,
3581	  otherwise error
3582
358326 September 2007
3584
3585* Add command aliases, so "ls" is an alias for "list".
3586* Rename some commands and alter syntax to take options after a la CVS. Also
3587  change some flags. So:
3588
3589	tmux -s/socket -nabc new
3590
3591  Becomes:
3592
3593	tmux -S/socket new -sabc
3594
3595* Major tidy and split of client/server code.
3596
359722 September 2007
3598
3599* Window list command (C-b W). Started by Maximilian Gass, finished by me.
3600
360120 September 2007
3602
3603* Specify meta via environment variable (META).
3604* Record last window and ^L key to switch to it. Largely from Maximilian Gass.
3605* Reset ignored signals in child after forkpty, makes ^C work.
3606* Wrap on next/previous. From Maximilian Gass.
3607
360819 September 2007
3609
3610* Don't renumber windows on close.
3611
361228 August 2007
3613
3614* Scrolling region (\e[r) support.
3615
361627 August 2007
3617
3618* Change screen.c to work more logically and hopefully fix heap corruption.
3619
362009 July 2007
3621
3622* Initial import to CVS. Basic functions are working, albeit with a couple of
3623  showstopper memory bugs and many missing features. Detaching, reattaching,
3624  creating new sessions, listing sessions work acceptably for using with shells.
3625  Simple curses programs (top, systat, tetris) and more complicated ones (mutt,
3626  emacs) that don't require scrolling regions (ESC[r) mostly work fine
3627  (including mutt, emacs). No status bar yet and no key remapping or other
3628  customisation.
3629