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