xref: /netbsd-src/external/bsd/tmux/dist/CHANGES (revision f8cf1a9151c7af1cb0bd8b09c13c66bca599c027)
1*f8cf1a91SwizCHANGES FROM 3.5 TO 3.5a
2*f8cf1a91Swiz
3*f8cf1a91Swiz* Do not translate BSpace as Unicode with extended keys.
4*f8cf1a91Swiz
5*f8cf1a91Swiz* Fix so that keys with Shift are represented correctly with extended keys.
6*f8cf1a91Swiz
7*f8cf1a91Swiz* Revert to using /bin/sh for #() and run-shell and if-shell; the change to use
8*f8cf1a91Swiz  default-shell only applies now to popups.
9*f8cf1a91Swiz
10*f8cf1a91Swiz* Fix grey colour without a number suffix in styles.
11*f8cf1a91Swiz
12*f8cf1a91SwizCHANGES FROM 3.4 TO 3.5
13*f8cf1a91Swiz
14*f8cf1a91Swiz* Revamp extended keys support to more closely match xterm and support mode 2
15*f8cf1a91Swiz  as well as mode 1. This is a substantial change to key handling which changes
16*f8cf1a91Swiz  tmux to always request mode 2 from parent terminal, changes to an unambiguous
17*f8cf1a91Swiz  internal representation of keys, and adds an option (extended-keys-format) to
18*f8cf1a91Swiz  control the format similar to the xterm(1) formatOtherKeys resource.
19*f8cf1a91Swiz
20*f8cf1a91Swiz* Clear an overlay (popup or menu) when command prompt is entered.
21*f8cf1a91Swiz
22*f8cf1a91Swiz* Add copy-mode -d flag to scroll a page down if in copy mode already (matching
23*f8cf1a91Swiz  -e).
24*f8cf1a91Swiz
25*f8cf1a91Swiz* Display hyperlinks in copy mode and add copy_cursor_hyperlink format to get
26*f8cf1a91Swiz  the hyperlink under the cursor.
27*f8cf1a91Swiz
28*f8cf1a91Swiz* Add a prefix timeout option.
29*f8cf1a91Swiz
30*f8cf1a91Swiz* Mouse move keys are not useful as key bindings because we do not turn them on
31*f8cf1a91Swiz  unless the application requests them. Ignore them so they do not cause the
32*f8cf1a91Swiz  prefix to be canceled
33*f8cf1a91Swiz
34*f8cf1a91Swiz* Add search_count and search_count_partial formats in copy mode.
35*f8cf1a91Swiz
36*f8cf1a91Swiz* Do not reset mouse pane if clicked on status line,
37*f8cf1a91Swiz
38*f8cf1a91Swiz* Add mirrored versions of the main-horizontal and main-vertical layouts where
39*f8cf1a91Swiz  the main pane is bottom or right instead of top or left.
40*f8cf1a91Swiz
41*f8cf1a91Swiz* Allow REP to work with Unicode characters.
42*f8cf1a91Swiz
43*f8cf1a91Swiz* Fix size calculation of terminators for clipboard escape sequences.
44*f8cf1a91Swiz
45*f8cf1a91Swiz* Treat CRLF as LF in config files where it is easy to do so.
46*f8cf1a91Swiz
47*f8cf1a91Swiz* The Linux console has some bugs with bright colours, so add some workarounds
48*f8cf1a91Swiz  for it.
49*f8cf1a91Swiz
50*f8cf1a91Swiz* If built with systemd, remove some environment variables it uses.
51*f8cf1a91Swiz
52*f8cf1a91Swiz* Adjust the logic when deleting last buffer to better preserve the selection:
53*f8cf1a91Swiz  if selecting the element below the deleted one fails (because as the last
54*f8cf1a91Swiz  one), select the one above it instead.
55*f8cf1a91Swiz
56*f8cf1a91Swiz* Add --enable-jemalloc to build with jemalloc memory allocator (since glibc
57*f8cf1a91Swiz  malloc is so poor).
58*f8cf1a91Swiz
59*f8cf1a91Swiz* Add a way (refresh-client -r) for control mode clients to provide OSC 10 and
60*f8cf1a91Swiz  11 responses to tmux so they can set the default foreground and background
61*f8cf1a91Swiz  colours.
62*f8cf1a91Swiz
63*f8cf1a91Swiz* Add N to search backwards in tree modes.
64*f8cf1a91Swiz
65*f8cf1a91Swiz* Use default-shell for command prompt, #() and popups.
66*f8cf1a91Swiz
67*f8cf1a91Swiz* Revert part of a change intended to improve search performance by skipping
68*f8cf1a91Swiz  parts of lines already searched, but which in fact skipped the ends of lines
69*f8cf1a91Swiz  altogether.
70*f8cf1a91Swiz
71*f8cf1a91Swiz* Add a command-error hook when a command fails.
72*f8cf1a91Swiz
73*f8cf1a91Swiz* Add an option allow-set-title to forbid applications from changing the pane
74*f8cf1a91Swiz  title.
75*f8cf1a91Swiz
76*f8cf1a91Swiz* Correct handling of mouse up events (don't ignore all but the last released
77*f8cf1a91Swiz  button), and always process down event for double click.
78*f8cf1a91Swiz
79*f8cf1a91Swiz* Fix a crash if focusing a pane that is exiting.
80*f8cf1a91Swiz
81*f8cf1a91Swiz* Pick newest session (as documented) when looking for next session for
82*f8cf1a91Swiz  detach-on-destroy.
83*f8cf1a91Swiz
84*f8cf1a91Swiz* Reduce default escape-time to 10 milliseconds.
85*f8cf1a91Swiz
86*f8cf1a91Swiz* Add display-menu -M to always turn mouse on in a menu.
87*f8cf1a91Swiz
88*f8cf1a91Swiz* Look for feature code 21 for DECSLRM and 28 for DECFRA in the device
89*f8cf1a91Swiz  attributes and also accept level 1.
90*f8cf1a91Swiz
91*f8cf1a91Swiz* Fix crash if built with SIXEL and the SIXEL colour register is invalid; also
92*f8cf1a91Swiz  remove SIXEL images before reflow.
93*f8cf1a91Swiz
94*f8cf1a91Swiz* Do not notify window-layout-changed if the window is about to be destroyed.
95*f8cf1a91Swiz
96*f8cf1a91Swiz* Do not consider a selection present if it is empty for the selection_active
97*f8cf1a91Swiz  and selection_present format variables.
98*f8cf1a91Swiz
99*f8cf1a91Swiz* Fix split-window -p.
100*f8cf1a91Swiz
101*f8cf1a91SwizCHANGES FROM 3.3a TO 3.4
102c23f9150Swiz
103c23f9150Swiz* Add options keep-last and keep-group to destroy-unattached to keep the last
104c23f9150Swiz  session whether in a group.
105c23f9150Swiz
106c23f9150Swiz* Don't allow paste-buffer into dead panes.
107c23f9150Swiz
108c23f9150Swiz* Add -t to source-file.
109c23f9150Swiz
110c23f9150Swiz* Rewrite combined character handling to be more consistent and to support
111c23f9150Swiz  newer Unicode combined characters.
112c23f9150Swiz
113c23f9150Swiz* Add basic support for SIXEL if built with --enable-sixel.
114c23f9150Swiz
115c23f9150Swiz* Add a session, pane and user mouse range types for the status line and add
116c23f9150Swiz  format variables for mouse_status_line and mouse_status_range so they can be
117c23f9150Swiz  associated with different commands in the key bindings.
118c23f9150Swiz
119c23f9150Swiz* Add flag (-o) to next-prompt/previous-prompt to go to OSC 133 command output.
120c23f9150Swiz
121c23f9150Swiz* Add options and flags for menu styles (menu-style, menu-border-style) similar
122c23f9150Swiz  to those existing for popups.
123c23f9150Swiz
124c23f9150Swiz* Add support for marking lines with a shell prompt based on the OSC 133 extension.
125c23f9150Swiz
126c23f9150Swiz* Check for libterminfo for NetBSD.
127c23f9150Swiz
128c23f9150Swiz* Add "us" to styles for underscore colour.
129c23f9150Swiz
130c23f9150Swiz* Add flags (-c and -y) to change the confirm key and default behaviour of
131c23f9150Swiz  confirm-before.
132c23f9150Swiz
133c23f9150Swiz* Use ncurses' new tparm_s function (added in 6.4-20230424) instead of tparm so
134c23f9150Swiz  it does not object to string arguments in c apabilities it doesn't already
135c23f9150Swiz  know. Also ignore errors from tparm if using previous ncurses versions.
136c23f9150Swiz
137c23f9150Swiz* Set default lock command to vlock on Linux if present at build time.
138c23f9150Swiz
139c23f9150Swiz* Discard mouse sequences that have the right form but actually are invalid.
140c23f9150Swiz
141c23f9150Swiz* Add support for spawning panes in separate cgroups with systemd and a
142c23f9150Swiz  configure flag (--disable-cgroups) to turn off.
143c23f9150Swiz
144c23f9150Swiz* Add a format (pane_unseen_changes) to show if there are unseen changes while
145c23f9150Swiz  in a mode.
146c23f9150Swiz
147c23f9150Swiz* Remove old buffer when renaming rather than complaining.
148c23f9150Swiz
149c23f9150Swiz* Add an L modifier like P, W, S to loop over clients.
150c23f9150Swiz
151c23f9150Swiz* Add -f to list-clients like the other list commands.
152c23f9150Swiz
153c23f9150Swiz* Extend display-message to work for control clients.
154c23f9150Swiz
155c23f9150Swiz* Add a flag to display-menu to select the manu item selected when the menu is
156c23f9150Swiz  open.
157c23f9150Swiz
158c23f9150Swiz* Have tmux recognise pasted text wrapped in bracket paste sequences, rather
159c23f9150Swiz  than only forwarding them to the program inside.
160c23f9150Swiz
161c23f9150Swiz* Have client return 1 if process is interrupted to an input pane.
162c23f9150Swiz
163c23f9150Swiz* Query the client terminal for foreground and background colours and if OSC 10
164c23f9150Swiz  or 11 is received but no colour has been set inside tmux, return the colour
165c23f9150Swiz  from the first attached client.
166c23f9150Swiz
167c23f9150Swiz* Add send-keys -K to handle keys directly as if typed (so look up in key
168c23f9150Swiz  table).
169c23f9150Swiz
170c23f9150Swiz* Process escape sequences in show-buffer.
171c23f9150Swiz
172c23f9150Swiz* Add a -l flag to display-message to disable format expansion.
173c23f9150Swiz
174c23f9150Swiz* Add paste-buffer-deleted notification and fix name of paste-buffer-changed.
175c23f9150Swiz
176c23f9150Swiz* Do not attempt to connect to the socket as a client if systemd is active.
177c23f9150Swiz
178c23f9150Swiz* Add scroll-top and scroll-bottom commands to scroll so cursor is at top or
179c23f9150Swiz  bottom.
180c23f9150Swiz
181c23f9150Swiz* Add a -T flag to capture-pane to stop at the last used cell instead of the
182c23f9150Swiz  full width. Restore the previous behaviour by making it default to off unless
183c23f9150Swiz  -J is used.
184c23f9150Swiz
185c23f9150Swiz* Add message-line option to control where message and prompt go.
186c23f9150Swiz
187*f8cf1a91Swiz* Notification when a paste buffer is deleted.
188c23f9150Swiz
189c23f9150Swiz* Add a Nobr terminfo(5) capability to tell tmux the terminal does not use bright
190c23f9150Swiz  colours for bold.
191c23f9150Swiz
192c23f9150Swiz* Change g and G to go to top and bottom in menus.
193c23f9150Swiz
194c23f9150Swiz* Add a third state "all" to allow-passthrough to work even in invisible panes.
195c23f9150Swiz
196c23f9150Swiz* Add support for OSC 8 hyperlinks.
197c23f9150Swiz
198c23f9150Swiz* Store the time lines are scrolled into history and display in copy mode.
199c23f9150Swiz
200c23f9150Swiz* Add a %config-error reply to control mode for configuration file errors since
201c23f9150Swiz  reporting them in view mode is useless.
202c23f9150Swiz
203c23f9150Swiz* A new feature flag (ignorefkeys) to ignore terminfo(5) function key
204c23f9150Swiz  definitions for rxvt.
205c23f9150Swiz
206c23f9150Swiz* Pass through first argument to OSC 52 (which clipboards to set) if the
207c23f9150Swiz  application provides it.
208c23f9150Swiz
209c23f9150Swiz* Expand arguments to send-keys, capture-pane, split-window, join-pane where it
210c23f9150Swiz  makes sense to do so.
211c23f9150Swiz
212c23f9150Swiz* Ignore named buffers when choosing a buffer if one is not specified by the user.
213c23f9150Swiz
2146db26757SwizCHANGES FROM 3.3 TO 3.3a
2156db26757Swiz
2166db26757Swiz* Do not crash when run-shell produces output from a config file.
2176db26757Swiz
2186db26757Swiz* Do not unintentionally turn off all mouse mode when button mode is also
2196db26757Swiz  present.
2206db26757Swiz
2216db26757SwizCHANGES FROM 3.2a TO 3.3
2226db26757Swiz
2236db26757Swiz* Add an ACL list for users connecting to the tmux socket. Users may be
2246db26757Swiz  forbidden from attaching, forced to attach read-only, or allowed to attach
2256db26757Swiz  read-write. A new command, server-access, configures the list. File system
2266db26757Swiz  permissions must still be configured manually.
2276db26757Swiz
2286db26757Swiz* Emit window-layout-changed on swap-pane.
2296db26757Swiz
2306db26757Swiz* Better error reporting when applying custom layouts.
2316db26757Swiz
2326db26757Swiz* Handle ANSI escape sequences in run-shell output.
2336db26757Swiz
2346db26757Swiz* Add pane_start_path to match start_command.
2356db26757Swiz
2366db26757Swiz* Set PWD so shells have a hint about the real path.
2376db26757Swiz
2386db26757Swiz* Do not allow pipe-pane on dead panes.
2396db26757Swiz
2406db26757Swiz* Do not report mouse positions (incorrectly) above the maximum of 223 in
2416db26757Swiz  normal mouse mode.
2426db26757Swiz
2436db26757Swiz* Add an option (default off) to control the passthrough escape sequence.
2446db26757Swiz
2456db26757Swiz* Support more mouse buttons when the terminal sends them.
2466db26757Swiz
2476db26757Swiz* Add a window-resized hook which is fired when the window is actually resized
2486db26757Swiz  which may be later than the client resize.
2496db26757Swiz
2506db26757Swiz* Add next_session_id format with the next session ID.
2516db26757Swiz
2526db26757Swiz* Add formats for client and server UID and user.
2536db26757Swiz
2546db26757Swiz* Add argument to refresh-client -l to forward clipboard to a pane.
2556db26757Swiz
2566db26757Swiz* Add remain-on-exit-format to set text shown when pane is dead.
2576db26757Swiz
2586db26757Swiz* With split-window -f use percentages of window size not pane size.
2596db26757Swiz
2606db26757Swiz* Add an option (fill-character) to set the character used for unused areas of
2616db26757Swiz  a client.
2626db26757Swiz
2636db26757Swiz* Add an option (scroll-on-clear) to control if tmux scrolls into history on
2646db26757Swiz  clear.
2656db26757Swiz
2666db26757Swiz* Add a capability for OSC 7 and use it similarly to how the title is set (and
2676db26757Swiz  controlled by the same set-titles option).
2686db26757Swiz
2696db26757Swiz* Add support for systemd socket activation (where systemd creates the Unix
2706db26757Swiz  domain socket for tmux rather than tmux creating it). Build with
2716db26757Swiz  --enable-systemd.
2726db26757Swiz
2736db26757Swiz* Add an option (pane-border-indicators) to select how the active pane is shown
2746db26757Swiz  on the pane border (colour, arrows or both).
2756db26757Swiz
2766db26757Swiz* Support underscore styles with capture-pane -e.
2776db26757Swiz
2786db26757Swiz* Make pane-border-format a pane option rather than window.
2796db26757Swiz
2806db26757Swiz* Respond to OSC 4 queries
2816db26757Swiz
2826db26757Swiz* Fix g/G keys in modes to do the same thing as copy mode (and vi).
2836db26757Swiz
2846db26757Swiz* Bump the time terminals have to respond to device attributes queries to three
2856db26757Swiz  seconds.
2866db26757Swiz
2876db26757Swiz* If automatic-rename is off, allow the rename escape sequence to set an empty
2886db26757Swiz  name.
2896db26757Swiz
2906db26757Swiz* Trim menu item text more intelligently.
2916db26757Swiz
2926db26757Swiz* Add cursor-style and cursor-colour options to set the default cursor style
2936db26757Swiz  and colour.
2946db26757Swiz
2956db26757Swiz* Accept some useful and non-conflicting emacs keys in vi normal mode at the
2966db26757Swiz  command prompt.
2976db26757Swiz
2986db26757Swiz* Add a format modifier (c) to force a colour to RGB.
2996db26757Swiz
3006db26757Swiz* Add -s and -S to display-popup to set styles, -b to set lines and -T to set
3016db26757Swiz  popup title. New popup-border-lines, popup-border-style and popup-style
3026db26757Swiz  options set the defaults.
3036db26757Swiz
3046db26757Swiz* Add -e flag to set an environment variable for a popup.
3056db26757Swiz
3066db26757Swiz* Make send-keys without arguments send the key it is bound to (if bound to a
3076db26757Swiz  key).
3086db26757Swiz
3096db26757Swiz* Try to leave terminal cursor at the right position even when tmux is drawing
3106db26757Swiz  its own cursor or selection (such as at the command prompt and in choose
3116db26757Swiz  mode) for people using screen readers and similar which can make use of it.
3126db26757Swiz
3136db26757Swiz* Change so that {} is converted to tmux commands immediately when parsed. This
3146db26757Swiz  means it must contain valid tmux commands. For commands which expand %% and
3156db26757Swiz  %%%, this now only happens within string arguments. Use of nested aliases
3166db26757Swiz  inside {} is now forbidden. Processing of commands given in quotes remains
3176db26757Swiz  the same.
3186db26757Swiz
3196db26757Swiz* Disable evports on SunOS since they are broken.
3206db26757Swiz
3216db26757Swiz* Do not expand the file given with tmux -f so it can contain :s.
3226db26757Swiz
3236db26757Swiz* Bump FORMAT_LOOP_LIMIT and add a log message when hit.
3246db26757Swiz
3256db26757Swiz* Add a terminal feature for the mouse (since FreeBSD termcap does not have kmous).
3266db26757Swiz
3276db26757Swiz* Forbid empty session names.
3286db26757Swiz
3296db26757Swiz* Improve error reporting when the tmux /tmp directory cannot be created or
3306db26757Swiz  used.
3316db26757Swiz
3326db26757Swiz* Give #() commands a one second grace period where the output is empty before
3336db26757Swiz  telling the user they aren't doing anything ("not ready").
3346db26757Swiz
3356db26757Swiz* When building, pick default-terminal from the first of tmux-256color, tmux,
3366db26757Swiz  screen-256color, screen that is available on the build system (--with-TERM
3376db26757Swiz  can override).
3386db26757Swiz
3396db26757Swiz* Do not close popups on resize, instead adjust them to fit.
3406db26757Swiz
3416db26757Swiz* Add a client-active hook.
3426db26757Swiz
3436db26757Swiz* Make window-linked and window-unlinked window options.
3446db26757Swiz
3456db26757Swiz* Do not configure on macOS without the user making a choice about utf8proc
3466db26757Swiz  (either --enable-utf8proc or --disable-utf8proc).
3476db26757Swiz
3486db26757Swiz* Do not freeze output in panes when a popup is open, let them continue to
3496db26757Swiz  redraw.
3506db26757Swiz
3516db26757Swiz* Add pipe variants of the line copy commands.
3526db26757Swiz
3536db26757Swiz* Change copy-line and copy-end-of-line not to cancel and add -and-cancel
3546db26757Swiz  variants, like the other copy commands.
3556db26757Swiz
3566db26757Swiz* Support the OSC palette-setting sequences in popups.
3576db26757Swiz
3586db26757Swiz* Add a pane-colours array option to specify the defaults palette.
3596db26757Swiz
3606db26757Swiz* Add support for Unicode zero-width joiner.
3616db26757Swiz
3626db26757Swiz* Make newline a style delimiter as well so they can cross multiple lines for
3636db26757Swiz  readability in configuration files.
3646db26757Swiz
3656db26757Swiz* Change focus to be driven by events rather than scanning panes so the
3666db26757Swiz  ordering of in and out is consistent.
3676db26757Swiz
3686db26757Swiz* Add display-popup -B to open a popup without a border.
3696db26757Swiz
3706db26757Swiz* Add a menu for popups that can be opened with button three outside the popup
3716db26757Swiz  or on the left or top border. Resizing now only works on the right and bottom
3726db26757Swiz  borders or when using Meta. The menu allows a popup to be closed, expanded to
3736db26757Swiz  the full size of the client, centered in the client or changed into a pane.
3746db26757Swiz
3756db26757Swiz* Make command-prompt and confirm-before block by default (like run-shell). A
3766db26757Swiz  new -b flags runs them in the background as before. Also set return code for
3776db26757Swiz  confirm-before.
3786db26757Swiz
3796db26757Swiz* Change cursor style handling so tmux understands which sequences contain
3806db26757Swiz  blinking and sets the flag appropriately, means that it works whether cnorm
3816db26757Swiz  disables blinking or not. This now matches xterm's behaviour.
3826db26757Swiz
3836db26757Swiz* More accurate vi(1) word navigation in copy mode and on the status line. This
3846db26757Swiz  changes the meaning of the word-separators option: setting it to the empty
3856db26757Swiz  string is equivalent to the previous behavior.
3866db26757Swiz
3876db26757Swiz* Add -F for command-prompt and use it to fix "Rename" on the window menu.
3886db26757Swiz
3896db26757Swiz* Add different command histories for different types of prompts ("command",
3906db26757Swiz  "search" etc).
3916db26757Swiz
392de7701e2SchristosCHANGES FROM 3.2 TO 3.2a
393de7701e2Schristos
394de7701e2Schristos* Add an "always" value for the "extended-keys" option; if set then tmux will
395de7701e2Schristos  forward extended keys to applications even if they do not request them.
396de7701e2Schristos
397de7701e2Schristos* Add a "mouse" terminal feature so tmux can enable the mouse on terminals
398de7701e2Schristos  where it is known to be supported even if terminfo(5) says otherwise.
399de7701e2Schristos
400de7701e2Schristos* Do not expand the filename given to -f so it can contain colons.
401de7701e2Schristos
402de7701e2Schristos* Fixes for problems with extended keys and modifiers, scroll region,
403de7701e2Schristos  source-file, crosscompiling, format modifiers and other minor issues.
404de7701e2Schristos
4059fb66d81SchristosCHANGES FROM 3.1c TO 3.2
4069fb66d81Schristos
4079fb66d81Schristos* Add a flag to disable keys to close a message.
4089fb66d81Schristos
4099fb66d81Schristos* Permit shortcut keys in buffer, client, tree modes to be configured with a
4109fb66d81Schristos  format (-K flag to choose-buffer, choose-client, choose-tree).
4119fb66d81Schristos
4129fb66d81Schristos* Add a current_file format for the config file being parsed.
4139fb66d81Schristos
4149fb66d81Schristos* When display-message used in config file, show the message after the config
4159fb66d81Schristos  file finishes.
4169fb66d81Schristos
4179fb66d81Schristos* Add client-detached notification in control mode.
4189fb66d81Schristos
4199fb66d81Schristos* Improve performance of format evaluation.
4209fb66d81Schristos
4219fb66d81Schristos* Make jump command support UTF-8 in copy mode.
4229fb66d81Schristos
4239fb66d81Schristos* Support X11 colour names and other colour formats for OSC 10 and 11.
4249fb66d81Schristos
4259fb66d81Schristos* Add "pipe" variants of "copy-pipe" commands which do not copy.
4269fb66d81Schristos
4279fb66d81Schristos* Include "focused" in client flags.
4289fb66d81Schristos
4299fb66d81Schristos* Send Unicode directional isolate characters around horizontal pane borders if
4309fb66d81Schristos  the terminal supports UTF-8 and an extension terminfo(5) capability "Bidi" is
4319fb66d81Schristos  present.
4329fb66d81Schristos
4339fb66d81Schristos* Add a -S flag to new-window to make it select the existing window if one
4349fb66d81Schristos  with the given name already exists rather than failing with an error.
4359fb66d81Schristos
436de7701e2Schristos* Add a format modifier to check if a window or session name exists (N/w or
4379fb66d81Schristos  N/s).
4389fb66d81Schristos
4399fb66d81Schristos* Add compat clock_gettime for older macOS.
4409fb66d81Schristos
4419fb66d81Schristos* Add a no-detached choice to detach-on-destroy which detaches only if there
4429fb66d81Schristos  are no other detached sessions to switch to.
4439fb66d81Schristos
4449fb66d81Schristos* Add rectangle-on and rectangle-off copy mode commands.
4459fb66d81Schristos
4469fb66d81Schristos* Change so that window_flags escapes # automatically. A new format
4479fb66d81Schristos  window_raw_flags contains the old unescaped version.
4489fb66d81Schristos
4499fb66d81Schristos* Add -N flag to never start server even if command would normally do so.
4509fb66d81Schristos
4519fb66d81Schristos* With incremental search, start empty and only repeat the previous search if
4529fb66d81Schristos  the user tries to search again with an empty prompt.
4539fb66d81Schristos
4549fb66d81Schristos* Add a value for remain-on-exit that only keeps the pane if the program
4559fb66d81Schristos  failed.
4569fb66d81Schristos
4579fb66d81Schristos* Add a -C flag to run-shell to use a tmux command rather than a shell command.
4589fb66d81Schristos
4599fb66d81Schristos* Do not list user options with show-hooks.
4609fb66d81Schristos
4619fb66d81Schristos* Remove current match indicator in copy mode which can't work anymore since we
4629fb66d81Schristos  only search the visible region.
4639fb66d81Schristos
4649fb66d81Schristos* Make synchronize-panes a pane option and add -U flag to set-option to unset
4659fb66d81Schristos  an option on all panes.
4669fb66d81Schristos
4679fb66d81Schristos* Make replacement of ##s consistent when drawing formats, whether followed by
468de7701e2Schristos  [ or not. Add a flag (e) to the q: format modifier to double up #s.
4699fb66d81Schristos
4709fb66d81Schristos* Add -N flag to display-panes to ignore keys.
4719fb66d81Schristos
4729fb66d81Schristos* Change how escaping is processed for formats so that ## and # can be used in
4739fb66d81Schristos  styles.
4749fb66d81Schristos
4759fb66d81Schristos* Add a 'w' format modifier for string width.
4769fb66d81Schristos
4779fb66d81Schristos* Add support for Haiku.
4789fb66d81Schristos
4799fb66d81Schristos* Expand menu and popup -x and -y as formats.
4809fb66d81Schristos
4819fb66d81Schristos* Add numeric comparisons for formats.
4829fb66d81Schristos
4839fb66d81Schristos* Fire focus events even when the pane is in a mode.
4849fb66d81Schristos
4859fb66d81Schristos* Add -O flag to display-menu to not automatically close when all mouse buttons
4869fb66d81Schristos  are released.
4879fb66d81Schristos
4889fb66d81Schristos* Allow fnmatch(3) wildcards in update-environment.
4899fb66d81Schristos
4909fb66d81Schristos* Disable nested job expansion so that the result of #() is not expanded again.
4919fb66d81Schristos
4929fb66d81Schristos* Use the setal capability as well as (tmux's) Setulc.
4939fb66d81Schristos
4949fb66d81Schristos* Add -q flag to unbind-key to hide errors.
4959fb66d81Schristos
4969fb66d81Schristos* Allow -N without a command to change or add a note to an existing key.
4979fb66d81Schristos
4989fb66d81Schristos* Add a -w flag to set- and load-buffer to send to clipboard using OSC 52.
4999fb66d81Schristos
5009fb66d81Schristos* Add -F to set-environment and source-file.
5019fb66d81Schristos
5029fb66d81Schristos* Allow colour to be spelt as color in various places.
5039fb66d81Schristos
5049fb66d81Schristos* Add n: modifier to get length of a format.
5059fb66d81Schristos
5069fb66d81Schristos* Respond to OSC colour requests if a colour is available.
5079fb66d81Schristos
5089fb66d81Schristos* Add a -d option to display-message to set delay.
5099fb66d81Schristos
5109fb66d81Schristos* Add a way for control mode clients to subscribe to a format and be notified
5119fb66d81Schristos  of changes rather than having to poll.
5129fb66d81Schristos
5139fb66d81Schristos* Add some formats for search in copy mode (search_present, search_match).
5149fb66d81Schristos
5159fb66d81Schristos* Do not wait on shutdown for commands started with run -b.
5169fb66d81Schristos
5179fb66d81Schristos* Add -b flags to insert a window before (like the existing -a for after) to
5189fb66d81Schristos  break-pane, move-window, new-window.
5199fb66d81Schristos
5209fb66d81Schristos* Make paste -p the default for ].
5219fb66d81Schristos
5229fb66d81Schristos* Add support for pausing a pane when the output buffered for a control mode
5239fb66d81Schristos  client gets too far behind. The pause-after flag with a time is set on the
5249fb66d81Schristos  pane with refresh-client -f and a paused pane may be resumed with
5259fb66d81Schristos  refresh-client -A.
5269fb66d81Schristos
5279fb66d81Schristos* Allow strings in configuration files to span multiple lines - newlines and
5289fb66d81Schristos  any leading whitespace are removed, as well as any following comments that
5299fb66d81Schristos  couldn't be part of a format. This allows long formats or other strings to be
5309fb66d81Schristos  annotated and indented.
5319fb66d81Schristos
5329fb66d81Schristos* Instead of using a custom parse function to process {} in configuration
5339fb66d81Schristos  files, treat as a set of statements the same as outside {} and convert back
5349fb66d81Schristos  to a string as the last step. This means the rules are consistent inside and
5359fb66d81Schristos  outside {}, %if and friends work at the right time, and the final result
5369fb66d81Schristos  isn't littered with unnecessary newlines.
5379fb66d81Schristos
5389fb66d81Schristos* Add support for extended keys - both xterm(1)'s CSI 27 ~ sequence and the
5399fb66d81Schristos  libtickit CSI u sequence are accepted; only the latter is output. tmux will
5409fb66d81Schristos  only attempt to use these if the extended-keys option is on and it can detect
5419fb66d81Schristos  that the terminal outside supports them (or is told it does with the
5429fb66d81Schristos  "extkeys" terminal feature).
5439fb66d81Schristos
5449fb66d81Schristos* Add an option to set the pane border lines style from a choice of single
5459fb66d81Schristos  lines (ACS or UTF-8), double or heavy (UTF-8), simple (plain ASCII) or number
5469fb66d81Schristos  (the pane numbers). Lines that won't work on a non-UTF-8 terminal are
5479fb66d81Schristos  translated back into ACS when they are output.
5489fb66d81Schristos
5499fb66d81Schristos* Make focus events update the latest client (like a key press).
5509fb66d81Schristos
5519fb66d81Schristos* Store UTF-8 characters differently to reduce memory use.
5529fb66d81Schristos
5539fb66d81Schristos* Fix break-pane -n when only one pane in the window.
5549fb66d81Schristos
5559fb66d81Schristos* Instead of sending all data to control mode clients as fast as possible, add
5569fb66d81Schristos  a limit of how much data will be sent to the client and try to use it for
5579fb66d81Schristos  panes with some degree of fairness.
5589fb66d81Schristos
5599fb66d81Schristos* Add an active-pane client flag (set with attach-session -f, new-session -f
5609fb66d81Schristos  or refresh-client -f). This allows a client to have an independent active
5619fb66d81Schristos  pane for interactive use (the window client pane is still used for many
5629fb66d81Schristos  things however).
5639fb66d81Schristos
5649fb66d81Schristos* Add a mark to copy mode, this is set with the set-mark command (bound to X)
5659fb66d81Schristos  and appears with the entire line shown using copy-mode-mark-style and the
5669fb66d81Schristos  marked character in reverse. The jump-to-mark command (bound to M-x) swaps
5679fb66d81Schristos  the mark and the cursor positions.
5689fb66d81Schristos
5699fb66d81Schristos* Add a -D flag to make the tmux server run in the foreground and not as a
5709fb66d81Schristos  daemon.
5719fb66d81Schristos
5729fb66d81Schristos* Do not loop forever in copy mode when search finds an empty match.
5739fb66d81Schristos
5749fb66d81Schristos* Fix the next-matching-bracket logic when using vi(1) keys.
5759fb66d81Schristos
5769fb66d81Schristos* Add a customize mode where options may be browsed and changed, includes
5779fb66d81Schristos  adding a brief description of each option. Bound to C-b C by default.
5789fb66d81Schristos
5799fb66d81Schristos* Change message log (C-b ~) so there is one for the server rather than one per
5809fb66d81Schristos  client and it remains after detach, and make it useful by logging every
5819fb66d81Schristos  command.
5829fb66d81Schristos
5839fb66d81Schristos* Add M-+ and M-- to tree mode to expand and collapse all.
5849fb66d81Schristos
5859fb66d81Schristos* Change the existing client flags for control mode to apply for any client,
5869fb66d81Schristos  use the same mechanism for the read-only flag and add an ignore-size flag.
5879fb66d81Schristos
5889fb66d81Schristos  refresh-client -F has become -f (-F stays for backwards compatibility) and
5899fb66d81Schristos  attach-session and switch-client now have -f flags also. A new format
5909fb66d81Schristos  client_flags lists the flags and is shown by list-clients by default.
5919fb66d81Schristos
5929fb66d81Schristos  This separates the read-only flag from "ignore size" behaviour (new
5939fb66d81Schristos  ignore-size) flag - both behaviours are useful in different circumstances.
5949fb66d81Schristos
5959fb66d81Schristos  attach -r and switchc -r remain and set or toggle both flags together.
5969fb66d81Schristos
5979fb66d81Schristos* Store and restore cursor position when copy mode is resized.
5989fb66d81Schristos
5999fb66d81Schristos* Export TERM_PROGRAM and TERM_PROGRAM_VERSION like various other terminals.
6009fb66d81Schristos
6019fb66d81Schristos* Add formats for after hook command arguments: hook_arguments with all the
6029fb66d81Schristos  arguments together; hook_argument_0, hook_argument_1 and so on with
6039fb66d81Schristos  individual arguments; hook_flag_X if flag -X is present; hook_flag_X_0,
6049fb66d81Schristos  hook_flag_X_1 and so on if -X appears multiple times.
6059fb66d81Schristos
6069fb66d81Schristos* Try to search the entire history first for up to 200 ms so a search count can
6079fb66d81Schristos  be shown. If it takes too long, search the visible text only.
6089fb66d81Schristos
6099fb66d81Schristos* Use VIS_CSTYLE for paste buffers also (show \012 as \n).
6109fb66d81Schristos
6119fb66d81Schristos* Change default formats for tree mode, client mode and buffer mode to be more
6129fb66d81Schristos  compact and remove some clutter.
6139fb66d81Schristos
6149fb66d81Schristos* Add a key (e) in buffer mode to open the buffer in an editor. The buffer
6159fb66d81Schristos  contents is updated when the editor exits.
6169fb66d81Schristos
6179fb66d81Schristos* Add -e flag for new-session to set environment variables, like the same flag
6189fb66d81Schristos  for new-window.
6199fb66d81Schristos
6209fb66d81Schristos* Improve search match marking in copy mode. Two new options
6219fb66d81Schristos  copy-mode-match-style and copy-mode-current-match-style to set the style for
6229fb66d81Schristos  matches and for the current match respectively. Also a change so that if a
6239fb66d81Schristos  copy key is pressed with no selection, the current match (if any) is copied.
6249fb66d81Schristos
6259fb66d81Schristos* Sanitize session names like window names instead of forbidding invalid ones.
6269fb66d81Schristos
6279fb66d81Schristos* Check if the clear terminfo(5) capability starts with CSI and if so then
6289fb66d81Schristos  assume the terminal is VT100-like, rather than relying on the XT capability.
6299fb66d81Schristos
6309fb66d81Schristos* Improve command prompt tab completion and add menus both for strings and -t
6319fb66d81Schristos  and -s (when used without a trailing space). command-prompt has additional
6329fb66d81Schristos  flags for only completing a window (-W) and a target (-T), allowing C-b ' to
6339fb66d81Schristos  only show windows and C-b . only targets.
6349fb66d81Schristos
6359fb66d81Schristos* Change all the style options to string options so they can support formats.
6366db26757Swiz  Change pane-active-border-style to use this to change the border colour when
6379fb66d81Schristos  in a mode or with synchronize-panes on. This also implies a few minor changes
6389fb66d81Schristos  to existing behaviour:
6399fb66d81Schristos
6409fb66d81Schristos  - set-option -a with a style option automatically inserts a comma between the
6419fb66d81Schristos    old value and appended text.
6429fb66d81Schristos
6439fb66d81Schristos  - OSC 10 and 11 no longer set the window-style option, instead they store the
6449fb66d81Schristos    colour internally in the pane data and it is used as the default when the
6459fb66d81Schristos    option is evaluated.
6469fb66d81Schristos
6479fb66d81Schristos  - status-fg and -bg now override status-style instead of the option values
6489fb66d81Schristos    being changed.
6499fb66d81Schristos
6509fb66d81Schristos* Add extension terminfo(5) capabilities for margins and focus reporting.
6519fb66d81Schristos
6529fb66d81Schristos* Try $XDG_CONFIG_HOME/tmux/tmux.conf as well as ~/.config/tmux/tmux.conf for
6539fb66d81Schristos  configuration file (the search paths are in TMUX_CONF in Makefile.am).
6549fb66d81Schristos
6559fb66d81Schristos* Remove the DSR 1337 iTerm2 extension and replace by the extended device
6569fb66d81Schristos  attributes sequence (CSI > q) supported by more terminals.
6579fb66d81Schristos
6589fb66d81Schristos* Add a -s flag to copy-mode to specify a different pane for the source
6599fb66d81Schristos  content. This means it is possible to view two places in a pane's history at
6609fb66d81Schristos  the same time in different panes, or view the history while still using the
6619fb66d81Schristos  pane. Pressing r refreshes the content from the source pane.
6629fb66d81Schristos
6639fb66d81Schristos* Add an argument to list-commands to show only a single command.
6649fb66d81Schristos
6659fb66d81Schristos* Change copy mode to make copy of the pane history so it does not need to
6669fb66d81Schristos  freeze the pane.
6679fb66d81Schristos
6689fb66d81Schristos* Restore pane_current_path format from portable tmux on OpenBSD.
6699fb66d81Schristos
6709fb66d81Schristos* Wait until the initial command sequence is done before sending a device
6719fb66d81Schristos  attributes request and other bits that prompt a reply from the terminal. This
672de7701e2Schristos  means that stray replies are not left on the terminal if the command has
6739fb66d81Schristos  attached and then immediately detached and tmux will not be around to receive
6749fb66d81Schristos  them.
6759fb66d81Schristos
6769fb66d81Schristos* Add a -f filter argument to the list commands like choose-tree.
6779fb66d81Schristos
6789fb66d81Schristos* Move specific hooks for panes to pane options and windows for window options
6799fb66d81Schristos  rather than all hooks being session options. These hooks are now window options:
6809fb66d81Schristos
6819fb66d81Schristos  window-layout-changed
6829fb66d81Schristos  window-linked
6839fb66d81Schristos  window-pane-changed
6849fb66d81Schristos  window-renamed
6859fb66d81Schristos  window-unlinked
6869fb66d81Schristos
687de7701e2Schristos  And these are now pane options:
6889fb66d81Schristos
6899fb66d81Schristos  pane-died
6909fb66d81Schristos  pane-exited
6919fb66d81Schristos  pane-focus-in
6929fb66d81Schristos  pane-focus-out
6939fb66d81Schristos  pane-mode-changed
6949fb66d81Schristos  pane-set-clipboard
6959fb66d81Schristos
6969fb66d81Schristos  Any existing configurations using these hooks on a session rather than
6979fb66d81Schristos  globally (that is, set-hook or set-option without -g) may need to be changed.
6989fb66d81Schristos
6999fb66d81Schristos* Show signal names when a process exits with remain-on-exit on platforms which
7009fb66d81Schristos  have a way to get them.
7019fb66d81Schristos
7029fb66d81Schristos* Start menu with top item selected if no mouse and use mode-style for the
7039fb66d81Schristos  selected item.
7049fb66d81Schristos
7059fb66d81Schristos* Add a copy-command option and change copy-pipe and friends to pipe to it if
7069fb66d81Schristos  used without arguments, allows all the default copy key bindings to be
7079fb66d81Schristos  changed to pipe with one option rather than needing to change each key
7089fb66d81Schristos  binding individually.
7099fb66d81Schristos
7109fb66d81Schristos* Tidy up the terminal detection and feature code and add named sets of
7119fb66d81Schristos  terminal features, each of which are defined in one place and map to a
7129fb66d81Schristos  builtin set of terminfo(5) capabilities. Features can be specified based on
7139fb66d81Schristos  TERM with a new terminal-features option or with the -T flag when running
7149fb66d81Schristos  tmux. tmux will also detect a few common terminals from the DA and DSR
7159fb66d81Schristos  responses.
7169fb66d81Schristos
7179fb66d81Schristos  This is intended to make it easier to configure tmux's use of terminfo(5)
7189fb66d81Schristos  even in the presence of outdated ncurses(3) or terminfo(5) databases or for
7199fb66d81Schristos  features which do not yet have a terminfo(5) entry. Instead of having to grok
7209fb66d81Schristos  terminfo(5) capability names and what they should be set to in the
7219fb66d81Schristos  terminal-overrides option, the user can hopefully just give tmux a feature
7229fb66d81Schristos  name and let it do the right thing.
7239fb66d81Schristos
7249fb66d81Schristos  The terminal-overrides option remains both for backwards compatibility and to
7259fb66d81Schristos  allow tweaks of individual capabilities.
7269fb66d81Schristos
7279fb66d81Schristos* Support mintty's application escape sequence (means tmux doesn't have to
7289fb66d81Schristos  delay to wait for Escape, so no need to reduce escape-time when using
7299fb66d81Schristos  mintty).
7309fb66d81Schristos
7319fb66d81Schristos* Change so main-pane-width and height can be given as a percentage.
7329fb66d81Schristos
7339fb66d81Schristos* Support for the iTerm2 synchronized updates feature (allows the terminal to
7349fb66d81Schristos  avoid unnecessary drawing while output is still in progress).
7359fb66d81Schristos
7369fb66d81Schristos* Make the mouse_word and mouse_line formats work in copy mode and enable the
7379fb66d81Schristos  default pane menu in copy mode.
7389fb66d81Schristos
7399fb66d81Schristos* Add a -T flag to resize-pane to trim lines below the cursor, moving lines out
7409fb66d81Schristos  of the history.
7419fb66d81Schristos
7429fb66d81Schristos* Add a way to mark environment variables as "hidden" so they can be used by
7439fb66d81Schristos  tmux (for example in formats) but are not set in the environment for new
7449fb66d81Schristos  panes. set-environment and show-environment have a new -h flag and there is a
7459fb66d81Schristos  new %hidden statement for the configuration file.
7469fb66d81Schristos
7479fb66d81Schristos* Change default position for display-menu -x and -y to centre rather than top
7489fb66d81Schristos  left.
7499fb66d81Schristos
7509fb66d81Schristos* Add support for per-client transient popups, similar to menus but which are
7519fb66d81Schristos  connected to an external command (like a pane). These are created with new
7529fb66d81Schristos  command display-popup.
7539fb66d81Schristos
7549fb66d81Schristos* Change double and triple click bindings so that only one is fired (previously
7559fb66d81Schristos  double click was fired on the way to triple click). Also add default double
7569fb66d81Schristos  and triple click bindings to copy the word or line under the cursor and
7579fb66d81Schristos  change the existing bindings in copy mode to do the same.
7589fb66d81Schristos
7599fb66d81Schristos* Add a default binding for button 2 to paste.
7609fb66d81Schristos
7619fb66d81Schristos* Add -d flag to run-shell to delay before running the command and allow it to
762de7701e2Schristos  be used without a command so it just delays.
7639fb66d81Schristos
7649fb66d81Schristos* Add C-g to cancel command prompt with vi keys as well as emacs, and q in
7659fb66d81Schristos  command mode.
7669fb66d81Schristos
7679fb66d81Schristos* When the server socket is given with -S, create it with umask 177 instead of
7689fb66d81Schristos  117 (because it may not be in a safe directory like the default directory in
7699fb66d81Schristos  /tmp).
7709fb66d81Schristos
7719fb66d81Schristos* Add a copy-mode -H flag to hide the position marker in the top right.
7729fb66d81Schristos
7739fb66d81Schristos* Add number operators for formats (+, -, *, / and m),
7749fb66d81Schristos
775aa83ff61SchristosCHANGED FROM 3.1b TO 3.1c
776aa83ff61Schristos
7779fb66d81Schristos* Do not write after the end of the array and overwrite the stack when
7789fb66d81Schristos  colon-separated SGR sequences contain empty arguments.
779aa83ff61Schristos
780aa83ff61SchristosCHANGES FROM 3.1a TO 3.1b
781aa83ff61Schristos
782aa83ff61Schristos* Fix build on systems without sys/queue.h.
783aa83ff61Schristos
784aa83ff61Schristos* Fix crash when allow-rename is on and an empty name is set.
785aa83ff61Schristos
786aa83ff61SchristosCHANGES FROM 3.1 TO 3.1a
787aa83ff61Schristos
788aa83ff61Schristos* Do not close stdout prematurely in control mode since it is needed to print
789aa83ff61Schristos  exit messages. Prevents hanging when detaching with iTerm2.
790aa83ff61Schristos
791aa83ff61SchristosCHANGES FROM 3.0a TO 3.1
792aa83ff61Schristos
793aa83ff61Schristos* Only search the visible part of the history when marking (highlighting)
794aa83ff61Schristos  search terms. This is much faster than searching the whole history and solves
795aa83ff61Schristos  problems with large histories. The count of matches shown is now the visible
796aa83ff61Schristos  matches rather than all matches.
797aa83ff61Schristos
798aa83ff61Schristos* Search using regular expressions in copy mode. search-forward and
799aa83ff61Schristos  search-backward use regular expressions by default; the incremental versions
800aa83ff61Schristos  do not.
801aa83ff61Schristos
802aa83ff61Schristos* Turn off mouse mode 1003 as well as the rest when exiting.
803aa83ff61Schristos
804aa83ff61Schristos* Add selection_active format for when the selection is present but not moving
805aa83ff61Schristos  with the cursor.
806aa83ff61Schristos
807aa83ff61Schristos* Fix dragging with modifier keys, so binding keys such as C-MouseDrag1Pane and
808aa83ff61Schristos  C-MouseDragEnd1Pane now work.
809aa83ff61Schristos
810aa83ff61Schristos* Add -a to list-keys to also list keys without notes with -N.
811aa83ff61Schristos
812aa83ff61Schristos* Do not jump to next word end if already on a word end when selecting a word;
813aa83ff61Schristos  fixes select-word with single character words and vi(1) keys.
814aa83ff61Schristos
815aa83ff61Schristos* Fix top and bottom pane calculation with pane border status enabled.
816aa83ff61Schristos
817aa83ff61Schristos* Add support for adding a note to a key binding (with bind-key -N) and use
818aa83ff61Schristos  this to add descriptions to the default key bindings. A new -N flag to
819aa83ff61Schristos  list-keys shows key bindings with notes. Change the default ? binding to use
820aa83ff61Schristos  this to show a readable summary of keys. Also extend command-prompt to return
821aa83ff61Schristos  the name of the key pressed and add a default binding (/) to show the note
822aa83ff61Schristos  for the next key pressed.
823aa83ff61Schristos
824aa83ff61Schristos* Add support for the iTerm2 DSR 1337 sequence to get the terminal version.
825aa83ff61Schristos
826aa83ff61Schristos* Treat plausible but invalid keys (like C-BSpace) as literal like any other
827aa83ff61Schristos  unrecognised string passed to send-keys.
828aa83ff61Schristos
829aa83ff61Schristos* Detect iTerm2 and enable use of DECSLRM (much faster with horizontally split
830aa83ff61Schristos  windows).
831aa83ff61Schristos
832aa83ff61Schristos* Add -Z to default switch-client command in tree mode.
833aa83ff61Schristos
834aa83ff61Schristos* Add ~ to quoted characters for %%%.
835aa83ff61Schristos
836aa83ff61Schristos* Document client exit messages in the manual page.
837aa83ff61Schristos
838aa83ff61Schristos* Do not let read-only clients limit the size, unless all clients are
839aa83ff61Schristos  read-only.
840aa83ff61Schristos
841aa83ff61Schristos* Add a number of new formats to inspect what sessions and clients a window is
842aa83ff61Schristos  present or active in.
843aa83ff61Schristos
844aa83ff61Schristos* Change file reading and writing to go through the client if necessary. This
845aa83ff61Schristos  fixes commands like "tmux loadb /dev/fd/X". Also modify source-file to
846aa83ff61Schristos  support "-" for standard input, like load-buffer and save-buffer.
847aa83ff61Schristos
848aa83ff61Schristos* Add ~/.config/tmux/tmux.conf to the default search path for configuration
849aa83ff61Schristos  files.
850aa83ff61Schristos
851aa83ff61Schristos* Bump the escape sequence timeout to five seconds to allow for longer
852aa83ff61Schristos  legitimate sequences.
853aa83ff61Schristos
854aa83ff61Schristos* Make a best effort to set xpixel and ypixel for each pane and add formats for
855aa83ff61Schristos  them.
856aa83ff61Schristos
857aa83ff61Schristos* Add push-default to status-left and status-right in status-format[0].
858aa83ff61Schristos
859aa83ff61Schristos* Do not clear search marks on cursor movement with vi(1) keys.
860aa83ff61Schristos
861aa83ff61Schristos* Add p format modifier for padding to width and allow multiple substitutions
862aa83ff61Schristos  in a single format.
863aa83ff61Schristos
864aa83ff61Schristos* Add -f for full size to join-pane (like split-window).
865aa83ff61Schristos
866aa83ff61Schristos* Do not use bright when emulating 256 colours on an 8 colour terminal because
867aa83ff61Schristos  it is also bold on some terminals.
868aa83ff61Schristos
869aa83ff61Schristos* Make select-pane -P set window-active-style also to match previous behaviour.
870aa83ff61Schristos
871aa83ff61Schristos* Do not truncate list-keys output.
872aa83ff61Schristos
873aa83ff61Schristos* Turn automatic-rename back on if the \033k rename escape sequence is used
874aa83ff61Schristos  with an empty name.
875aa83ff61Schristos
876aa83ff61Schristos* Add support for percentage sizes for resize-pane ("-x 10%"). Also change
877aa83ff61Schristos  split-window and join-pane -l to accept similar percentages and deprecate the
878aa83ff61Schristos  -p flag.
879aa83ff61Schristos
880aa83ff61Schristos* Add -F flag to send-keys to expand formats in search-backward and forward
881aa83ff61Schristos  copy mode commands and copy_cursor_word and copy_cursor_line formats for word
882aa83ff61Schristos  and line at cursor in copy mode. Use for default # and * binding with vi(1)
883aa83ff61Schristos  keys.
884aa83ff61Schristos
885aa83ff61Schristos* Add formats for word and line at cursor position in copy mode.
886aa83ff61Schristos
887aa83ff61Schristos* Add formats for cursor and selection position in copy mode.
888aa83ff61Schristos
889aa83ff61Schristos* Support all the forms of RGB colour strings in OSC sequences rather than
890aa83ff61Schristos  requiring two digits.
891aa83ff61Schristos
892aa83ff61Schristos* Limit lazy resize to panes in attached sessions only.
893aa83ff61Schristos
894aa83ff61Schristos* Add an option to set the key sent by backspace for those whose system uses ^H
895aa83ff61Schristos  rather than ^?.
896aa83ff61Schristos
897aa83ff61Schristos* Change new-session -A without a session name (that is, no -s option also) to
898aa83ff61Schristos  attach to the best existing session like attach-session rather than a new
899aa83ff61Schristos  one.
900aa83ff61Schristos
901aa83ff61Schristos* Add a "latest" window-size option which tries to size windows based on the
902aa83ff61Schristos  most recently used client. This is now the default.
903aa83ff61Schristos
904aa83ff61Schristos* Add simple support for OSC 7 (result is available in the pane_path format).
905aa83ff61Schristos
906aa83ff61Schristos* Add push-default and pop-default for styles which change the colours and
907aa83ff61Schristos  attributes used for #[default]. These are used in status-format to restore
908aa83ff61Schristos  the behaviour of window-status-style being the default for
909aa83ff61Schristos  window-status-format.
910aa83ff61Schristos
911aa83ff61Schristos* Add window_marked_flag.
912aa83ff61Schristos
913aa83ff61Schristos* Add cursor-down-and-cancel in copy mode.
914aa83ff61Schristos
915aa83ff61Schristos* Default to previous search string for search-forward and search-backward.
916aa83ff61Schristos
917aa83ff61Schristos* Add -Z flag to rotate-window, select-pane, swap-pane, switch-client to
918aa83ff61Schristos  preserve zoomed state.
919aa83ff61Schristos
920aa83ff61Schristos* Add -N to capture-pane to preserve trailing spaces.
921aa83ff61Schristos
922aa83ff61Schristos* Add reverse sorting in tree, client and buffer modes.
923aa83ff61Schristos
924aa83ff61SchristosCHANGES FROM 3.0 TO 3.0a
9256483eba0Schristos
9266483eba0Schristos* Do not require REG_STARTEND.
9276483eba0Schristos
9286483eba0Schristos* Respawn panes or windows correctly if default-command is set.
9296483eba0Schristos
9306483eba0Schristos* Add missing option for after-kill-pane hook.
9316483eba0Schristos
9326483eba0Schristos* Fix for crash with a format variable that doesn't exist.
9336483eba0Schristos
9346483eba0Schristos* Do not truncate list-keys output on some platforms.
9356483eba0Schristos
9366483eba0Schristos* Do not crash when restoring a layout with only one pane.
9376483eba0Schristos
938aa83ff61SchristosCHANGES FROM 2.9 TO 3.0
9396483eba0Schristos
9406483eba0Schristos* Workaround invalid layout strings generated by older tmux versions and add
9416483eba0Schristos  some additional sanity checks
9426483eba0Schristos
9436483eba0Schristos* xterm 348 now disables margins when resized, so send DECLRMM again after
9446483eba0Schristos  resize.
9456483eba0Schristos
9466483eba0Schristos* Add support for the SD (scroll down) escape sequence.
9476483eba0Schristos
9486483eba0Schristos* Expand arguments to C and s format modifiers to match the m modifier.
9496483eba0Schristos
9506483eba0Schristos* Add support for underscore colours (Setulc capability must be added with
9516483eba0Schristos  terminal-overrides as described in tmux(1)).
9526483eba0Schristos
9536483eba0Schristos* Add a "fill" style attribute for the fill colour of the drawing area (where
9546483eba0Schristos  appropriate).
9556483eba0Schristos
9566483eba0Schristos* New -H flag to send-keys to send literal keys.
9576483eba0Schristos
9586483eba0Schristos* Format variables for pane mouse modes (mouse_utf8_flag and mouse_sgr_flag)
9596483eba0Schristos  and for origin mode (origin_flag).
9606483eba0Schristos
9616483eba0Schristos* Add -F to refresh-client for flags for control mode clients, only one flag
9626483eba0Schristos  (no-output) supported at the moment.
9636483eba0Schristos
9646483eba0Schristos* Add a few vi(1) keys for menus.
9656483eba0Schristos
9666483eba0Schristos* Add pane options, set with set-option -p and displayed with show-options -p.
9676483eba0Schristos  Pane options inherit from window options (so every pane option is also
9686483eba0Schristos  a window option). The pane style is now configured by setting window-style
9696483eba0Schristos  and window-active-style in the pane options; select-pane -P and -g now change
9706483eba0Schristos  the option but are no longer documented.
9716483eba0Schristos
9726483eba0Schristos* Do not document set-window-option and show-window-options. set-option -w and
9736483eba0Schristos  show-options -w should be used instead.
9746483eba0Schristos
9756483eba0Schristos* Add a -A flag to show-options to show parent options as well (they are marked
9766483eba0Schristos  with a *).
9776483eba0Schristos
9786483eba0Schristos* Resize panes lazily - do not resize unless they are in an attached, active
9796483eba0Schristos  window.
9806483eba0Schristos
9816483eba0Schristos* Add regular expression support for the format search, match and substitute
9826483eba0Schristos  modifiers and make them able to ignore case. find-window now accepts -r to
9836483eba0Schristos  use regular expressions.
9846483eba0Schristos
9856483eba0Schristos* Do not use $TMUX to find the session because for windows in multiple sessions
9866483eba0Schristos  it is wrong as often as it is right, and for windows in one session it is
9876483eba0Schristos  pointless. Instead use TMUX_PANE if it is present.
9886483eba0Schristos
9896483eba0Schristos* Do not always resize the window back to its original size after applying a
9906483eba0Schristos  layout, keep it at the layout size until it must be resized (for example when
9916483eba0Schristos  attached and window-size is not manual).
9926483eba0Schristos
9936483eba0Schristos* Add new-session -X and attach-session -x to send SIGHUP to parent when
9946483eba0Schristos  detaching (like detach-client -P).
9956483eba0Schristos
9966483eba0Schristos* Support for octal escapes in strings (such as \007) and improve list-keys
9976483eba0Schristos  output so it parses correctly if copied into a configuration file.
9986483eba0Schristos
9996483eba0Schristos* INCOMPATIBLE: Add a new {} syntax to the configuration file. This is a string
10006483eba0Schristos  similar to single quotes but also includes newlines and allows commands that
10016483eba0Schristos  take other commands as string arguments to be expressed more clearly and
10026483eba0Schristos  without additional escaping.
10036483eba0Schristos
10046483eba0Schristos  A literal { and } or a string containing { or } must now be escaped or
10056483eba0Schristos  quoted, for example '{' and '}' instead of { or }, or 'X#{foo}' instead of
10066483eba0Schristos  X#{foo}.
10076483eba0Schristos
10086483eba0Schristos* New <, >, <= and >= comparison operators for formats.
10096483eba0Schristos
10106483eba0Schristos* Improve escaping of special characters in list-keys output.
10116483eba0Schristos
10126483eba0Schristos* INCOMPATIBLE: tmux's configuration parsing has changed to use yacc(1). There
10136483eba0Schristos  is one incompatible change: a \ on its own must be escaped or quoted as
10146483eba0Schristos  either \\ or '\' (the latter works on older tmux versions).
10156483eba0Schristos
10166483eba0Schristos  Entirely the same parser is now used for parsing the configuration file
10176483eba0Schristos  and for string commands. This means that constructs previously only
10186483eba0Schristos  available in .tmux.conf, such as %if, can now be used in string commands
10196483eba0Schristos  (for example, those given to if-shell - not commands invoked from the
10206483eba0Schristos  shell, they are still parsed by the shell itself).
10216483eba0Schristos
10226483eba0Schristos* Add support for the overline attribute (SGR 53). The Smol capability is
10236483eba0Schristos  needed in terminal-overrides.
10246483eba0Schristos
10256483eba0Schristos* Add the ability to create simple menus. Introduces new command
10266483eba0Schristos  display-menu. Default menus are bound to MouseDown3 on the status line;
10276483eba0Schristos  MouseDown3 or M-MouseDown3 on panes; MouseDown3 in tree, client and
1028aa83ff61Schristos  buffer modes; and C-b < and >.
10296483eba0Schristos
10306483eba0Schristos* Allow panes to be empty (no command). They can be created either by piping to
10316483eba0Schristos  split-window -I, or by passing an empty command ('') to split-window. Output
10326483eba0Schristos  can be sent to an existing empty window with display-message -I.
10336483eba0Schristos
10346483eba0Schristos* Add keys to jump between matching brackets (emacs C-M-f and C-M-b, vi %).
10356483eba0Schristos
10366483eba0Schristos* Add a -e flag to new-window, split-window, respawn-window, respawn-pane to
10376483eba0Schristos  pass environment variables into the newly created process.
10386483eba0Schristos
10396483eba0Schristos* Hooks are now stored in the options tree as array options, allowing them to
10406483eba0Schristos  have multiple separate commands. set-hook and show-hooks remain but
10416483eba0Schristos  set-option and show-options can now also be used (show-options will only show
10426483eba0Schristos  hooks if given the -H flag). Hooks with multiple commands are run in index
10436483eba0Schristos  order.
10446483eba0Schristos
10456483eba0Schristos* Automatically scroll if dragging to create a selection with the mouse and the
10466483eba0Schristos  cursor reaches the top or bottom line.
10476483eba0Schristos
10486483eba0Schristos* Add -no-clear variants of copy-selection and copy-pipe which do not clear the
10496483eba0Schristos  selection after copying. Make copy-pipe clear the selection by default to be
10506483eba0Schristos  consistent with copy-selection.
10516483eba0Schristos
10526483eba0Schristos* Add an argument to copy commands to set the prefix for the buffer name, this
10536483eba0Schristos  (for example) allows buffers for different sessions to be named separately.
10546483eba0Schristos
10556483eba0Schristos* Update session activity on focus event.
10566483eba0Schristos
10576483eba0Schristos* Pass target from source-file into the config file parser so formats in %if
10586483eba0Schristos  and %endif have access to more useful variables.
10596483eba0Schristos
10606483eba0Schristos* Add the ability to infer an option type (server, session, window) from its
10616483eba0Schristos  name to show-options (it was already present in set-option).
10626483eba0Schristos
1063aa83ff61SchristosCHANGES FROM 2.9 TO 2.9a
1064ef36e747Schristos
1065ef36e747Schristos* Fix bugs in select-pane and the main-horizontal and main-vertical layouts.
1066ef36e747Schristos
1067aa83ff61SchristosCHANGES FROM 2.8 TO 2.9
1068ef36e747Schristos
1069ef36e747Schristos* Attempt to preserve horizontal cursor position as well as vertical with
1070ef36e747Schristos  reflow.
1071ef36e747Schristos
1072ef36e747Schristos* Rewrite main-vertical and horizontal and change layouts to better handle the
1073ef36e747Schristos  case where all panes won't fit into the window size, reduce problems with
1074ef36e747Schristos  pane border status lines and fix other bugs mostly found by Thomas Sattler.
1075ef36e747Schristos
1076ef36e747Schristos* Add format variables for the default formats in the various modes
1077ef36e747Schristos  (tree_mode_format and so on) and add a -a flag to display-message to list
1078ef36e747Schristos  variables with values.
1079ef36e747Schristos
1080ef36e747Schristos* Add a -v flag to display-message to show verbose messages as the format is
1081ef36e747Schristos  parsed, this allows formats to be debugged
1082ef36e747Schristos
1083ef36e747Schristos* Add support for HPA (\033[`).
1084ef36e747Schristos
1085ef36e747Schristos* Add support for origin mode (\033[?6h).
1086ef36e747Schristos
1087ef36e747Schristos* No longer clear history on RIS.
1088ef36e747Schristos
1089ef36e747Schristos* Extend the #[] style syntax and use that together with previous format
1090ef36e747Schristos  changes to allow the status line to be entirely configured with a single
1091ef36e747Schristos  option.
1092ef36e747Schristos
1093ef36e747Schristos  Now that it is possible to configure their content, enable the existing code
1094ef36e747Schristos  that lets the status line be multiple lines in height. The status option can
1095ef36e747Schristos  now take a value of 2, 3, 4 or 5 (as well as the previous on or off) to
1096ef36e747Schristos  configure more than one line. The new status-format array option configures
1097ef36e747Schristos  the format of each line, the default just references the existing status-*
1098ef36e747Schristos  options, although some of the more obscure status options may be eliminated
1099ef36e747Schristos  in time.
1100ef36e747Schristos
1101ef36e747Schristos  Additions to the #[] syntax are: "align" to specify alignment (left, centre,
1102ef36e747Schristos  right), "list" for the window list and "range" to configure ranges of text
1103ef36e747Schristos  for the mouse bindings.
1104ef36e747Schristos
1105ef36e747Schristos  The "align" keyword can also be used to specify alignment of entries in tree
1106ef36e747Schristos  mode and the pane status lines.
1107ef36e747Schristos
1108ef36e747Schristos* Add E: and T: format modifiers to expand a format twice (useful to expand the
1109ef36e747Schristos  value of an option).
1110ef36e747Schristos
1111ef36e747Schristos* The individual -fg, -bg and -attr options have been removed; they
1112ef36e747Schristos  were superseded by -style options in tmux 1.9.
1113ef36e747Schristos
1114ef36e747Schristos* Allow more than one mode to be opened in a pane. Modes are kept on a stack
1115ef36e747Schristos  and retrieved if the same mode is entered again. Exiting the active mode goes
1116ef36e747Schristos  back to the previous one.
1117ef36e747Schristos
1118ef36e747Schristos* When showing command output in copy mode, call it view mode instead (affects
1119ef36e747Schristos  pane_mode format).
1120ef36e747Schristos
1121ef36e747Schristos* Add -b to display-panes like run-shell.
1122ef36e747Schristos
1123ef36e747Schristos* Handle UTF-8 in word-separators option.
1124ef36e747Schristos
1125ef36e747Schristos* New "terminal" colour allowing options to use the terminal default colour
1126ef36e747Schristos  rather than inheriting the default from a parent option.
1127ef36e747Schristos
1128ef36e747Schristos* Do not move the cursor in copy mode when the mouse wheel is used.
1129ef36e747Schristos
1130ef36e747Schristos* Use the same working directory rules for jobs as new windows rather than
1131ef36e747Schristos  always starting in the user's home.
1132ef36e747Schristos
1133ef36e747Schristos* Allow panes to be one line or column in size.
1134ef36e747Schristos
1135ef36e747Schristos* Go to last line when goto-line number is out of range in copy mode.
1136ef36e747Schristos
1137ef36e747Schristos* Yank previously cut text if any with C-y in the command prompt, only use the
1138ef36e747Schristos  buffer if no text has been cut.
1139ef36e747Schristos
1140ef36e747Schristos* Add q: format modifier to quote shell special characters.
1141ef36e747Schristos
1142ef36e747Schristos* Add StatusLeft and StatusRight mouse locations (keys such as
1143ef36e747Schristos  MouseDown1StatusLeft) for the status-left and status-right areas of the
1144ef36e747Schristos  status line.
1145ef36e747Schristos
1146ef36e747Schristos* Add -Z to find-window.
1147ef36e747Schristos
1148ef36e747Schristos* Support for windows larger than the client. This adds two new options,
1149ef36e747Schristos  window-size and default-size, and a new command, resize-window. The
1150ef36e747Schristos  force-width and force-height options and the session_width and session_height
1151ef36e747Schristos  formats have been removed.
1152ef36e747Schristos
1153ef36e747Schristos  The new window-size option tells tmux how to work out the size of windows:
1154ef36e747Schristos  largest means it picks the size of the largest session, smallest the smallest
1155ef36e747Schristos  session (similar to the old behaviour) and manual means that it does not
1156ef36e747Schristos  automatically resize windows. aggressive-resize modifies the choice of
1157ef36e747Schristos  session for largest and smallest as it did before.
1158ef36e747Schristos
1159ef36e747Schristos  If a window is in a session attached to a client that is too small, only part
1160ef36e747Schristos  of the window is shown. tmux attempts to keep the cursor visible, so the part
1161ef36e747Schristos  of the window displayed is changed as the cursor moves (with a small delay,
1162ef36e747Schristos  to try and avoid excess redrawing when applications redraw status lines or
1163ef36e747Schristos  similar that are not currently visible).
1164ef36e747Schristos
1165ef36e747Schristos  Drawing windows which are larger than the client is not as efficient as those
1166ef36e747Schristos  which fit, particularly when the cursor moves, so it is recommended to avoid
1167ef36e747Schristos  using this on slow machines or networks (set window-size to smallest or
1168ef36e747Schristos  manual).
1169ef36e747Schristos
1170ef36e747Schristos  The resize-window command can be used to resize a window manually. If it is
1171ef36e747Schristos  used, the window-size option is automatically set to manual for the window
1172ef36e747Schristos  (undo this with "setw -u window-size"). resize-window works in a similar way
1173ef36e747Schristos  to resize-pane (-U -D -L -R -x -y flags) but also has -a and -A flags. -a
1174ef36e747Schristos  sets the window to the size of the smallest client (what it would be if
1175ef36e747Schristos  window-size was smallest) and -A the largest.
1176ef36e747Schristos
1177ef36e747Schristos  For the same behaviour as force-width or force-height, use resize-window -x
1178ef36e747Schristos  or -y.
1179ef36e747Schristos
1180ef36e747Schristos  If the global window-size option is set to manual, the default-size option is
1181ef36e747Schristos  used for new windows. If -x or -y is used with new-session, that sets the
1182ef36e747Schristos  default-size option for the new session.
1183ef36e747Schristos
1184ef36e747Schristos  The maximum size of a window is 10000x10000. But expect applications to
1185ef36e747Schristos  complain and higher memory use if making a window that big. The minimum size
1186ef36e747Schristos  is the size required for the current layout including borders.
1187ef36e747Schristos
1188ef36e747Schristos  The refresh-client command can be used to pan around a window, -U -D -L -R
1189ef36e747Schristos  moves up, down, left or right and -c returns to automatic cursor
1190ef36e747Schristos  tracking. The position is reset when the current window is changed.
1191ef36e747Schristos
1192aa83ff61SchristosCHANGES FROM 2.7 TO 2.8
11938f3b9483Schristos
11948f3b9483Schristos* Make display-panes block the client until a pane is chosen or it
11958f3b9483Schristos  times out.
11968f3b9483Schristos
11978f3b9483Schristos* Clear history on RIS like most other terminals do.
11988f3b9483Schristos
11998f3b9483Schristos* Add an "Any" key to run a command if a key is pressed that is not
12008f3b9483Schristos  bound in the current key table.
12018f3b9483Schristos
12028f3b9483Schristos* Expand formats in load-buffer and save-buffer.
12038f3b9483Schristos
12048f3b9483Schristos* Add a rectangle_toggle format.
12058f3b9483Schristos
12068f3b9483Schristos* Add set-hook -R to run a hook immediately.
12078f3b9483Schristos
12088f3b9483Schristos* Add README.ja.
12098f3b9483Schristos
12108f3b9483Schristos* Add pane focus hooks.
12118f3b9483Schristos
12128f3b9483Schristos* Allow any punctuation as separator for s/x/y not only /.
12138f3b9483Schristos
12148f3b9483Schristos* Improve resizing with the mouse (fix resizing the wrong pane in some
12158f3b9483Schristos  layouts, and allow resizing multiple panes at the same time).
12168f3b9483Schristos
12178f3b9483Schristos* Allow , and } to be escaped in formats as #, and #}.
12188f3b9483Schristos
12198f3b9483Schristos* Add KRB5CCNAME to update-environment.
12208f3b9483Schristos
12218f3b9483Schristos* Change meaning of -c to display-message so the client is used if it
12228f3b9483Schristos  matches the session given to -t.
12238f3b9483Schristos
12248f3b9483Schristos* Fixes to : form of SGR.
12258f3b9483Schristos
12268f3b9483Schristos* Add x and X to choose-tree to kill sessions, windows or panes.
12278f3b9483Schristos
12288f3b9483SchristosCHANGES FROM 2.6 TO 2.7
12298f3b9483Schristos
12308f3b9483Schristos* Remove EVENT_* variables from environment on platforms where tmux uses them
12318f3b9483Schristos  so they do not pass on to panes.
12328f3b9483Schristos
12338f3b9483Schristos* Fixes for hooks at server exit.
12348f3b9483Schristos
12358f3b9483Schristos* Remove SGR 10 (was equivalent to SGR 0 but no other terminal seems to do
12368f3b9483Schristos  this).
12378f3b9483Schristos
12388f3b9483Schristos* Expand formats in window and session names.
12398f3b9483Schristos
12408f3b9483Schristos* Add -Z flag to choose-tree, choose-client, choose-buffer to automatically
12418f3b9483Schristos  zoom the pane when the mode is entered and unzoom when it exits, assuming the
12428f3b9483Schristos  pane is not already zoomed. This is now part of the default key bindings.
12438f3b9483Schristos
12448f3b9483Schristos* Add C-g to exit modes with emacs keys.
12458f3b9483Schristos
12468f3b9483Schristos* Add exit-empty option to exit server if no sessions (defaults to on).
12478f3b9483Schristos
12488f3b9483Schristos* Show if a filter is present in choose modes.
12498f3b9483Schristos
12508f3b9483Schristos* Add pipe-pane -I to to connect stdin of the child process.
12518f3b9483Schristos
12528f3b9483Schristos* Performance improvements for reflow.
12538f3b9483Schristos
12548f3b9483Schristos* Use RGB terminfo(5) capability to detect RGB colour terminals (the existing
12558f3b9483Schristos  Tc extension remains unchanged).
12568f3b9483Schristos
12578f3b9483Schristos* Support for ISO colon-separated SGR sequences.
12588f3b9483Schristos
12598f3b9483Schristos* Add select-layout -E to spread panes out evenly (bound to E key).
12608f3b9483Schristos
12618f3b9483Schristos* Support wide characters properly when reflowing.
12628f3b9483Schristos
12638f3b9483Schristos* Pass PWD to new panes as a hint to shells, as well as calling chdir().
12648f3b9483Schristos
12658f3b9483Schristos* Performance improvements for the various choose modes.
12668f3b9483Schristos
12678f3b9483Schristos* Only show first member of session groups in tree mode (-G flag to choose-tree
12688f3b9483Schristos  to show all).
12698f3b9483Schristos
12708f3b9483Schristos* Support %else in config files to match %if; from Brad Town in GitHub issue
12718f3b9483Schristos  1071.
12728f3b9483Schristos
12738f3b9483Schristos* Fix "kind" terminfo(5) capability to be S-Down not S-Up.
12748f3b9483Schristos
12758f3b9483Schristos* Add a box around the preview label in tree mode.
12768f3b9483Schristos
12778f3b9483Schristos* Show exit status and time in the remain-on-exit pane text; from Timo
12788f3b9483Schristos  Boettcher in GitHub issue 1103.
12798f3b9483Schristos
12808f3b9483Schristos* Correctly use pane-base-index in tree mode.
12818f3b9483Schristos
12828f3b9483Schristos* Change the allow-rename option default to off.
12838f3b9483Schristos
12848f3b9483Schristos* Support for xterm(1) title stack escape sequences (GitHub issue 1075 from
12858f3b9483Schristos  Brad Town).
12868f3b9483Schristos
12878f3b9483Schristos* Correctly remove padding cells to fix a UTF-8 display problem (GitHub issue
12888f3b9483Schristos  1090).
12898f3b9483Schristos
1290c9ad075bSchristosCHANGES FROM 2.5 TO 2.6, 05 October 2017
1291c9ad075bSchristos
1292c9ad075bSchristos* Add select-pane -T to set pane title.
1293c9ad075bSchristos
1294c9ad075bSchristos* Fix memory leak when lines with BCE are removed from history.
1295c9ad075bSchristos
1296c9ad075bSchristos* Fix (again) the "prefer unattached" behaviour of attach-session.
1297c9ad075bSchristos
1298c9ad075bSchristos* Reorder how keys are checked to allow keys to be specified that have a
1299c9ad075bSchristos  leading escape. GitHub issue 1048.
1300c9ad075bSchristos
1301c9ad075bSchristos* Support REP escape sequence (\033[b).
1302c9ad075bSchristos
1303c9ad075bSchristos* Run alert hooks based on options rather than always, and allow further bells
1304c9ad075bSchristos  even if there is an existing bell.
1305c9ad075bSchristos
1306c9ad075bSchristos* Add -d flag to display-panes to override display-panes-time.
1307c9ad075bSchristos
1308c9ad075bSchristos* Add selection_present format when in copy mode (allows key bindings that do
1309c9ad075bSchristos  something different if there is a selection).
1310c9ad075bSchristos
1311c9ad075bSchristos* Add pane_at_left, pane_at_right, pane_at_top and pane_at_bottom formats.
1312c9ad075bSchristos
1313c9ad075bSchristos* Make bell, activity and silence alerting more consistent by: removing the
1314c9ad075bSchristos  bell-on-alert option; adding activity-action and silence-action options with
1315c9ad075bSchristos  the same possible values as the existing bell-action; adding a "both" value
1316c9ad075bSchristos  for the visual-bell, visual-activity and visual-silence options to trigger
1317c9ad075bSchristos  both a bell and a message.
1318c9ad075bSchristos
1319c9ad075bSchristos* Add a pane_pipe format to show if pipe-pane is active.
1320c9ad075bSchristos
1321c9ad075bSchristos* Block signals between forking and resetting signal handlers so that the
1322c9ad075bSchristos  libevent signal handler doesn't get called in the child and incorrectly write
1323c9ad075bSchristos  into the signal pipe that it still shares with the parent. GitHub issue 1001.
1324c9ad075bSchristos
1325c9ad075bSchristos* Allow punctuation in pane_current_command.
1326c9ad075bSchristos
1327c9ad075bSchristos* Add -c for respawn-pane and respawn-window.
1328c9ad075bSchristos
1329c9ad075bSchristos* Wait for any remaining data to flush when a pane is closed while pipe-pane is
1330c9ad075bSchristos  in use.
1331c9ad075bSchristos
1332c9ad075bSchristos* Fix working out current client with no target. GitHub issue 995.
1333c9ad075bSchristos
1334c9ad075bSchristos* Try to fallback to C.UTF-8 as well as en_US.UTF-8 when looking for a UTF-8
1335c9ad075bSchristos  locale.
1336c9ad075bSchristos
1337c9ad075bSchristos* Add user-keys option for user-defined key escape sequences (mapped to User0
1338c9ad075bSchristos  to User999 keys).
1339c9ad075bSchristos
1340c9ad075bSchristos* Add pane-set-clipboard hook.
1341c9ad075bSchristos
1342c9ad075bSchristos* FAQ file has moved out of repository to online.
1343c9ad075bSchristos
1344c9ad075bSchristos* Fix problem with high CPU usage when a client dies unexpectedly. GitHub issue
1345c9ad075bSchristos  941.
1346c9ad075bSchristos
1347c9ad075bSchristos* Do a dance on OS X 10.10 and above to return tmux to the user namespace,
1348c9ad075bSchristos  allowing access to the clipboard.
1349c9ad075bSchristos
1350c9ad075bSchristos* Do not allow escape sequences which expect a specific terminator (APC, DSC,
1351c9ad075bSchristos  OSC) to wait for forever - use a small timeout. This reduces the chance of
1352c9ad075bSchristos  the pane locking up completely when sent garbage (cat /dev/random or
1353c9ad075bSchristos  similar).
1354c9ad075bSchristos
1355c9ad075bSchristos* Support SIGUSR2 to toggle logging on a running server, also generate the
1356c9ad075bSchristos  "out" log file with -vv not -vvvv.
1357c9ad075bSchristos
1358c9ad075bSchristos* Make set-clipboard a three state option: on (tmux both sends to outside
1359c9ad075bSchristos  terminal and accepts from applications inside); external (tmux sends outside
1360c9ad075bSchristos  but does not accept inside); and off.
1361c9ad075bSchristos
1362c9ad075bSchristos* Fix OSC 4 palette setting for bright foreground colours. GitHub issue 954.
1363c9ad075bSchristos
1364c9ad075bSchristos* Use setrgbf and setrgbb terminfo(5) capabilities to set RGB colours, if they
1365c9ad075bSchristos  are available. (Tc is still supported as well.)
1366c9ad075bSchristos
1367c9ad075bSchristos* Fix redrawing panes when they are resized several times but end up with the
1368c9ad075bSchristos  size unchanged (for example, splitw/resizep -Z/breakp).
1369c9ad075bSchristos
1370c9ad075bSchristos* Major rewrite of choose mode. Now includes preview, sorting, searching and
1371c9ad075bSchristos  tagging; commands that can be executed directly from the mode (for example,
1372c9ad075bSchristos  to delete one or more buffers); and filtering in tree mode.
1373c9ad075bSchristos
1374c9ad075bSchristos* choose-window and choose-session are now aliases of choose-tree (in the
1375c9ad075bSchristos  command-alias option).
1376c9ad075bSchristos
1377c9ad075bSchristos* Support OSC 10 and OSC 11 to set foreground and background colours.
1378c9ad075bSchristos
1379c9ad075bSchristos* Check the U8 capability to determine whether to use UTF-8 line drawing
1380c9ad075bSchristos  characters for ACS.
1381c9ad075bSchristos
1382c9ad075bSchristos* Some missing notifications for layout changes.
1383c9ad075bSchristos
1384c9ad075bSchristos* Control mode clients now do not affect session sizes until they issue
1385c9ad075bSchristos  refresh-client -C. new-session -x and -y works with control clients even if
1386c9ad075bSchristos  the session is not detached.
1387c9ad075bSchristos
1388c9ad075bSchristos* All new sessions that are unattached (whether with -d or started with no
1389c9ad075bSchristos  terminal) are now created with size 80 x 24. Whether the status line is on or
1390c9ad075bSchristos  off does not affect the size of new sessions until they are attached.
1391c9ad075bSchristos
1392c9ad075bSchristos* Expand formats in option names and add -F flag to expand them in option values.
1393c9ad075bSchristos
1394c9ad075bSchristos* Remember the search string for a pane even if copy mode is exited and entered
1395c9ad075bSchristos  again.
1396c9ad075bSchristos
1397c9ad075bSchristos* Some further BCE fixes (scroll up, reverse index).
1398c9ad075bSchristos
1399c9ad075bSchristos* Improvements to how terminals are cleared (entirely or partially).
1400c9ad075bSchristos
1401c9ad075bSchristosCHANGES FROM 2.4 TO 2.5, 09 May 2017
1402c9ad075bSchristos
1403c9ad075bSchristos* Reset updated flag when restarting #() command so that new output is properly
1404c9ad075bSchristos  recognised. GitHub issue 922.
1405c9ad075bSchristos
1406c9ad075bSchristos* Fix ECH with a background colour.
1407c9ad075bSchristos
1408c9ad075bSchristos* Do not rely on the terminal not moving the cursor after DL or EL.
1409c9ad075bSchristos
1410c9ad075bSchristos* Fix send-keys and send-prefix in copy-mode (so C-b C-b works). GitHub issue
1411c9ad075bSchristos  905.
1412c9ad075bSchristos
1413c9ad075bSchristos* Set the current pane for rotate-window so it works in command sequences.
1414c9ad075bSchristos
1415c9ad075bSchristos* Add pane_mode format.
1416c9ad075bSchristos
1417c9ad075bSchristos* Differentiate M-Up from Escape+Up when possible (that is, in terminals with
1418c9ad075bSchristos  xterm(1) style function keys). GitHub issue 907.
1419c9ad075bSchristos
1420c9ad075bSchristos* Add session_stack and window_stack_index formats.
1421c9ad075bSchristos
1422c9ad075bSchristos* Some new control mode notifications and corresponding hooks:
1423c9ad075bSchristos  pane-mode-changed, window-pane-changed, client-session-changed,
1424c9ad075bSchristos  session-window-changed.
1425c9ad075bSchristos
1426c9ad075bSchristos* Format pane_search_string for last search term while in copy mode (useful
1427c9ad075bSchristos  with command-prompt -I).
1428c9ad075bSchristos
1429c9ad075bSchristos* Fix a problem with high CPU usage and multiple clients with #(). GitHub issue
1430c9ad075bSchristos  889.
1431c9ad075bSchristos
1432c9ad075bSchristos* Fix UTF-8 combining characters in column 0.
1433c9ad075bSchristos
1434c9ad075bSchristos* Fix reference counting so that panes are properly destroyed and their
1435c9ad075bSchristos  processes killed.
1436c9ad075bSchristos
1437c9ad075bSchristos* Clamp SU (CSI S) parameter to work around a bug in Konsole.
1438c9ad075bSchristos
1439c9ad075bSchristos* Tweak line wrapping in full width panes to play more nicely with terminal
1440c9ad075bSchristos  copy and paste.
1441c9ad075bSchristos
1442c9ad075bSchristos* Fix when we emit SGR 0 in capture-pane -e.
1443c9ad075bSchristos
1444c9ad075bSchristos* Do not change TERM until after config file parsing has finished, so that
1445c9ad075bSchristos  commands run inside the config file can use it to make decisions (typically
1446c9ad075bSchristos  about default-terminal).
1447c9ad075bSchristos
1448c9ad075bSchristos* Make the initial client wait until config file parsing has finished to avoid
1449c9ad075bSchristos  racing with commands.
1450c9ad075bSchristos
1451c9ad075bSchristos* Fix core when if-shell fails.
1452c9ad075bSchristos
1453c9ad075bSchristos* Only use ED to clear screen if the pane is at the bottom.
1454c9ad075bSchristos
1455c9ad075bSchristos* Fix multibyte UTF-8 output.
1456c9ad075bSchristos
1457c9ad075bSchristos* Code improvements around target (-t) resolution.
1458c9ad075bSchristos
1459c9ad075bSchristos* Change how the default target (for commands without -t) is managed across
1460c9ad075bSchristos  command sequences: now it is set up at the start and commands are required
1461c9ad075bSchristos  to update it if needed. Fixes binding command sequences to mouse keys.
1462c9ad075bSchristos
1463c9ad075bSchristos* Make if-shell from the config file work correctly.
1464c9ad075bSchristos
1465c9ad075bSchristos* Change to always check the root key table if no binding is found in the
1466c9ad075bSchristos  current table (prefix table or copy-mode table or whatever). This means that
1467c9ad075bSchristos  root key bindings will take effect even in copy mode, if not overridden by a
1468c9ad075bSchristos  copy mode key binding.
1469c9ad075bSchristos
1470c9ad075bSchristos* Fix so that the history file works again.
1471c9ad075bSchristos
1472c9ad075bSchristos* Run config file without a client rather than using the first client, restores
1473c9ad075bSchristos  previous behaviour.
1474c9ad075bSchristos
1475c9ad075bSchristos* If a #() command doesn't exit, continue to read from it and use its last full
1476c9ad075bSchristos  line of output.
1477c9ad075bSchristos
1478c9ad075bSchristos* Handle slow terminals and fast output better: when the amount of data
1479c9ad075bSchristos  outstanding gets too large, discard output until it is drained and we are
1480c9ad075bSchristos  able to do a full redraw. Prevents tmux sitting on a huge buffer that the
1481c9ad075bSchristos  terminal will take forever to consume.
1482c9ad075bSchristos
1483c9ad075bSchristos* Do not redraw a client unless we realistically think it can accept the data -
1484c9ad075bSchristos  defer redraws until the client has nothing else waiting to write.
1485c9ad075bSchristos
1486c9ad075bSchristosCHANGES FROM 2.3 TO 2.4, 20 April 2017
14874e179ddaSchristos
14884e179ddaSchristosIncompatible Changes
14894e179ddaSchristos====================
14904e179ddaSchristos
14914e179ddaSchristos* Key tables have undergone major changes. Mode key tables are no longer
14924e179ddaSchristos  separate from the main key tables. All mode key tables have been removed,
14934e179ddaSchristos  together with the -t flag to bind-key and unbind-key.
14944e179ddaSchristos
14954e179ddaSchristos  The emacs-edit, vi-edit, emacs-choose and vi-choose tables have been replaced
14964e179ddaSchristos  by fixed key bindings in the command prompt and choose modes. The mode-keys
14974e179ddaSchristos  and status-keys options remain.
14984e179ddaSchristos
14994e179ddaSchristos  The emacs-copy and vi-copy tables have been replaced by the copy-mode and
15004e179ddaSchristos  copy-mode-vi tables. Commands are sent using the -X and -N flags to
15014e179ddaSchristos  send-keys. So the following:
15024e179ddaSchristos
15034e179ddaSchristos    bind -temacs-copy C-Up scroll-up
15044e179ddaSchristos    bind -temacs-copy -R5 WheelUpPane scroll-up
15054e179ddaSchristos
15064e179ddaSchristos  Becomes:
15074e179ddaSchristos
15084e179ddaSchristos    bind -Tcopy-mode C-Up send -X scroll-up
15094e179ddaSchristos    bind -Tcopy-mode WheelUpPane send -N5 -X scroll-up
15104e179ddaSchristos
1511c9ad075bSchristos  These changes allows the full command parser (including command sequences) and
15124e179ddaSchristos  command set to be used - for example, the normal command prompt with editing
15134e179ddaSchristos  and history is now used for searching, jumping, and so on instead of a custom
15144e179ddaSchristos  one. The default C-r binding is now:
15154e179ddaSchristos
1516c9ad075bSchristos    bind -Tcopy-mode C-r command-prompt -i -p'search up' "send -X search-backward-incremental '%%'"
15174e179ddaSchristos
1518c23f9150Swiz  There are also some new commands available with send -X, such as
15194e179ddaSchristos  copy-pipe-and-cancel.
15204e179ddaSchristos* set-remain-on-exit has gone -- can be achieved with hooks instead.
15214e179ddaSchristos* Hooks: before hooks have been removed and only a selection of commands now
15224e179ddaSchristos  have after hooks (they are no longer automatic). Additional hooks have been
15234e179ddaSchristos  added.
15244e179ddaSchristos* The xterm-keys option now defaults to on.
15254e179ddaSchristos
15264e179ddaSchristosNormal Changes
15274e179ddaSchristos==============
15284e179ddaSchristos
15294e179ddaSchristos* Support for mouse double and triple clicks.
15304e179ddaSchristos* BCE (Background Colour Erase) is now supported.
15314e179ddaSchristos* All occurrences of a search string in copy mode are now highlighted;
15324e179ddaSchristos  additionally, the number of search results is displayed. The highlighting
15334e179ddaSchristos  updates interactively with the default emacs key bindings (incremental
15344e179ddaSchristos  search).
15354e179ddaSchristos* source-file now understands glob patterns.
15364e179ddaSchristos* Formats now have simple comparisons:
15374e179ddaSchristos
15384e179ddaSchristos    #{==:a,b}
15394e179ddaSchristos    #{!=:a,b}
15404e179ddaSchristos
15414e179ddaSchristos* There are the following new formats:
15424e179ddaSchristos
15434e179ddaSchristos  - #{version} -- the tmux server version;
15444e179ddaSchristos  - #{client_termtype} -- the terminal type of the client;
15454e179ddaSchristos  - #{client_name} -- the name of a client;
15464e179ddaSchristos  - #{client_written} -- the number of bytes written to the client.
15474e179ddaSchristos
15484e179ddaSchristos* The configuration file now accepts %if/%endif conditional blocks which are
15494e179ddaSchristos  processed when it is parsed; the argument is a format string (useful with the
15504e179ddaSchristos  new format comparison options).
15514e179ddaSchristos* detach-client now has -E to execute a command replacing the client instead of
15524e179ddaSchristos  exiting.
15534e179ddaSchristos* Add support for custom command aliases, this is an array option which
15544e179ddaSchristos  contains items of the form "alias=command". This is consulted when an
15554e179ddaSchristos  unknown command is parsed.
15564e179ddaSchristos* break-pane now has -n to specify the new window name.
15574e179ddaSchristos* OSC 52 support has been added for programs inside tmux to set a tmux buffer.
15584e179ddaSchristos* The mouse "all event" mode (1003) is now supported.
15594e179ddaSchristos* Palette setting is now possible (OSC 4 and 104).
15604e179ddaSchristos* Strikethrough support (a recent terminfo is required).
15614e179ddaSchristos* Grouped sessions can now be named (new -t).
15624e179ddaSchristos* terminal-overrides and update-environment are now array options (the previous
15634e179ddaSchristos  set -ag syntax should work without change).
15644e179ddaSchristos* There have been substantial performance improvements.
15654e179ddaSchristos
1566c9ad075bSchristosCHANGES FROM 2.2 TO 2.3, 29 September 2016
15674e179ddaSchristos
15684e179ddaSchristosIncompatible Changes
15694e179ddaSchristos====================
15704e179ddaSchristos
15714e179ddaSchristosNone.
15724e179ddaSchristos
15734e179ddaSchristosNormal Changes
15744e179ddaSchristos==============
15754e179ddaSchristos
15764e179ddaSchristos* New option 'pane-border-status' to add text in the pane borders.
15774e179ddaSchristos* Support for hooks on commands: 'after' and 'before' hooks.
15784e179ddaSchristos* 'source-file' understands '-q' to suppress errors for nonexistent files.
15794e179ddaSchristos* Lots of UTF8 improvements, especially on MacOS.
15804e179ddaSchristos* 'window-status-separator' understands #[] expansions.
15814e179ddaSchristos* 'split-window' understands '-f' for performing a full-width split.
15824e179ddaSchristos* Allow report count to be specified when using 'bind-key -R'.
15834e179ddaSchristos* 'set -a' for appending to user options (@foo) is now supported.
15844e179ddaSchristos* 'display-panes' can now accept a command to run, rather than always
15854e179ddaSchristos  selecting the pane.
15864e179ddaSchristos
1587c9ad075bSchristosCHANGES FROM 2.1 TO 2.2, 10 April 2016
15884e179ddaSchristos
15894e179ddaSchristosIncompatible Changes
15904e179ddaSchristos====================
15914e179ddaSchristos
15924e179ddaSchristos* The format strings which referenced time have been removed.  Instead:
15934e179ddaSchristos
15944e179ddaSchristos  #{t:window_activity}
15954e179ddaSchristos
15964e179ddaSchristoscan be used.
15974e179ddaSchristos
15984e179ddaSchristos* Support for TMPDIR has been removed.  Use TMUX_TMPDIR instead.
15994e179ddaSchristos* UTF8 detection now happens automatically if the client supports it, hence
16004e179ddaSchristos  the:
16014e179ddaSchristos
16024e179ddaSchristos  mouse-utf8
16034e179ddaSchristos  utf8
16044e179ddaSchristos
16054e179ddaSchristos  options has been removed.
16064e179ddaSchristos* The:
16074e179ddaSchristos
16084e179ddaSchristos  mouse_utf8_flag
16094e179ddaSchristos
16104e179ddaSchristos  format string has been removed.
16114e179ddaSchristos* The -I option to show-messages has been removed.  See:
16124e179ddaSchristos
16134e179ddaSchristos  #{t:start_time}
16144e179ddaSchristos
16154e179ddaSchristos  format option instead.
16164e179ddaSchristos
16174e179ddaSchristosNormal Changes
16184e179ddaSchristos==============
16194e179ddaSchristos
16204e179ddaSchristos* Panes are unzoomed with selectp -LRUD
16214e179ddaSchristos* New formats added:
16224e179ddaSchristos
16234e179ddaSchristos  #{scroll_position}
16244e179ddaSchristos  #{socket_path}
16254e179ddaSchristos  #{=10:...} -- limit to N characters (from the start)
16264e179ddaSchristos  #{=-10:...} -- limit to N characters (from the end)
16274e179ddaSchristos  #{t:...} -- used to format time-based formats
16284e179ddaSchristos  #{b:...} -- used to ascertain basename from string
16294e179ddaSchristos  #{d:...} -- used to ascertain dirname from string
16304e179ddaSchristos  #{s:...} -- used to perform substitutions on a string
16314e179ddaSchristos
16324e179ddaSchristos* Job output is run via the format system, so formats work again
16334e179ddaSchristos* If display-time is set to 0, then the indicators wait for a key to be
16344e179ddaSchristos  pressed.
16354e179ddaSchristos* list-keys and list-commands can be run without starting the tmux server.
16364e179ddaSchristos* kill-session learns -C to clear all alerts in all windows of the session.
16374e179ddaSchristos* Support for hooks (internal for now), but hooks for the following have been
16384e179ddaSchristos  implemented:
16394e179ddaSchristos
16404e179ddaSchristos  alert-bell
16414e179ddaSchristos  alert-silence
16424e179ddaSchristos  alert-activity
16434e179ddaSchristos  client-attached
16444e179ddaSchristos  client-detached
16454e179ddaSchristos  client-resized
16464e179ddaSchristos  pane-died
16474e179ddaSchristos  pane-exited
16484e179ddaSchristos
16494e179ddaSchristos* RGB (24bit) colour support.  The 'Tc' flag must be set in the external TERM
16504e179ddaSchristos  entry (using terminal-overrides or a custom terminfo entry).
16514e179ddaSchristos
1652c9ad075bSchristosCHANGES FROM 2.0 TO 2.1, 18 October 2015
16534e179ddaSchristos
16544e179ddaSchristosIncompatible Changes
16554e179ddaSchristos====================
16564e179ddaSchristos
16574e179ddaSchristos* Mouse-mode has been rewritten.  There's now no longer options for:
16584e179ddaSchristos	- mouse-resize-pane
16594e179ddaSchristos	- mouse-select-pane
16604e179ddaSchristos	- mouse-select-window
16614e179ddaSchristos	- mode-mouse
16624e179ddaSchristos
16634e179ddaSchristos  Instead there is just one option:  'mouse' which turns on mouse support
16644e179ddaSchristos  entirely.
16654e179ddaSchristos* 'default-terminal' is now a session option.  Furthermore, if this is set
16664e179ddaSchristos  to 'screen-*' then emulate what screen does.  If italics are wanted, this
16674e179ddaSchristos  can be set to 'tmux' but this is still new and not necessarily supported
16684e179ddaSchristos  on all platforms with older ncurses installs.
16694e179ddaSchristos* The c0-* options for rate-limiting have been removed.  Instead, a backoff
16704e179ddaSchristos  approach is used.
16714e179ddaSchristos
16724e179ddaSchristosNormal Changes
16734e179ddaSchristos==============
16744e179ddaSchristos
16754e179ddaSchristos* New formats:
16764e179ddaSchristos	- session_activity
16774e179ddaSchristos	- window_linked
16784e179ddaSchristos	- window_activity_format
16794e179ddaSchristos	- session_alerts
16804e179ddaSchristos	- session_last_attached
16814e179ddaSchristos	- client_pid
16824e179ddaSchristos	- pid
16834e179ddaSchristos* 'copy-selection', 'append-selection', 'start-named-buffer' now understand
16844e179ddaSchristos  an '-x' flag to prevent it exiting copying mode.
16854e179ddaSchristos* 'select-pane' now understands '-P' to set window/pane background colours.
16864e179ddaSchristos* 'renumber-windows' now understands windows which are unlinked.
16874e179ddaSchristos* 'bind' now understands multiple key tables.  Allows for key-chaining.
16884e179ddaSchristos* 'select-layout' understands '-o' to undo the last layout change.
16894e179ddaSchristos* The environment is updated when switching sessions as well as attaching.
16904e179ddaSchristos* 'select-pane' now understands '-M' for marking a pane.  This marked pane
16914e179ddaSchristos  can then be used with commands which understand src-pane specifiers
16924e179ddaSchristos  automatically.
16934e179ddaSchristos* If a session/window target is prefixed with '=' then only an exact match
16944e179ddaSchristos  is considered.
16954e179ddaSchristos* 'move-window' understands '-a'.
16964e179ddaSchristos* 'update-environment' understands '-E' when attach-session is used on an
16974e179ddaSchristos  already attached client.
16984e179ddaSchristos* 'show-environment' understands '-s' to output Bourne-compatible commands.
16994e179ddaSchristos* New option: 'history-file' to save/restore command prompt history.
17004e179ddaSchristos* Copy mode is exited if the history is cleared whilst in copy-mode.
17014e179ddaSchristos* 'copy-mode' learned '-e' to exit copy-mode when scrolling to end.
17024e179ddaSchristos
1703c9ad075bSchristosCHANGES FROM 1.9a TO 2.0, 06 March 2015
17044e179ddaSchristos
17054e179ddaSchristosIncompatible Changes
17064e179ddaSchristos====================
17074e179ddaSchristos
17084e179ddaSchristos* The choose-list command has been removed.
17094e179ddaSchristos* 'terminal-overrides' is now a server option, not a session option.
17104e179ddaSchristos* 'message-limit' is now a server option, not a session option.
17114e179ddaSchristos* 'monitor-content' option has been removed.
17124e179ddaSchristos* 'pane_start_path' option has been removed.
17134e179ddaSchristos* The "info" mechanism which used to (for some commands) provide feedback
17144e179ddaSchristos  has been removed, and like other commands, they now produce nothing on
17154e179ddaSchristos  success.
17164e179ddaSchristos
17174e179ddaSchristosNormal Changes
17184e179ddaSchristos==============
17194e179ddaSchristos
17204e179ddaSchristos* tmux can now write an entry to utmp if the library 'utempter' is present
17214e179ddaSchristos  at compile time.
17224e179ddaSchristos* set-buffer learned append mode (-a), and a corresponding
17234e179ddaSchristos  'append-selection' command has been added to copy-mode.
17244e179ddaSchristos* choose-mode now has the following commands which can be bound:
17254e179ddaSchristos	- start-of-list
17264e179ddaSchristos	- end-of-list
17274e179ddaSchristos	- top-line
17284e179ddaSchristos	- bottom-line
17294e179ddaSchristos
17304e179ddaSchristos* choose-buffer now understands UTF-8.
17314e179ddaSchristos* Pane navigation has changed:
17324e179ddaSchristos	- The old way of always using the top or left if the choice is ambiguous.
17334e179ddaSchristos	- The new way of remembering the last used pane is annoying if the
17344e179ddaSchristos	  layout is balanced and the leftmost is obvious to the user (because
17354e179ddaSchristos	  clearly if we go right from the top-left in a tiled set of four we want
17364e179ddaSchristos	  to end up in top-right, even if we were last using the bottom-right).
17374e179ddaSchristos
17384e179ddaSchristos      So instead, use a combination of both: if there is only one possible
17394e179ddaSchristos      pane alongside the current pane, move to it, otherwise choose the most
17404e179ddaSchristos      recently used of the choice.
17414e179ddaSchristos* 'set-buffer' can now be told to give names to buffers.
17424e179ddaSchristos* The 'new-session', 'new-window', 'split-window', and 'respawn-pane' commands
17434e179ddaSchristos  now understand multiple arguments and handle quoting problems correctly.
17444e179ddaSchristos* 'capture-pane' understands '-S-' to mean the start of the pane, and '-E-' to
17454e179ddaSchristos  mean the end of the pane.
17464e179ddaSchristos* Support for function keys beyond F12 has changed.  The following explains:
17474e179ddaSchristos	- F13-F24 are S-F1 to S-F12
17484e179ddaSchristos	- F25-F36 are C-F1 to C-F12
17494e179ddaSchristos	- F37-F48 are C-S-F1 to C-S-F12
17504e179ddaSchristos	- F49-F60 are M-F1 to M-F12
17514e179ddaSchristos	- F61-F63 are M-S-F1 to M-S-F3
17524e179ddaSchristos
17534e179ddaSchristos Therefore, F13 becomes a binding of S-F1, etc.
17544e179ddaSchristos* Support using pane id as part of session or window specifier (so % means
17554e179ddaSchristos  session-of-%1 or window-of-%1) and window id as part of session
17564e179ddaSchristos  (so @1 means session-of-@1).
17574e179ddaSchristos* 'copy-pipe' command now understands formats via -F
17584e179ddaSchristos* 'if-shell'  command now understands formats via -F
17594e179ddaSchristos* 'split-window' and 'join-window' understand -b to create the pane to the left
17604e179ddaSchristos  or above the target pane.
17614e179ddaSchristos
1762c9ad075bSchristosCHANGES FROM 1.9 TO 1.9a, 22 February 2014
17634e179ddaSchristos
17644e179ddaSchristosNOTE: This is a bug-fix release to address some important bugs which just
17654e179ddaSchristosmissed the 1.9 deadline, but were found afterwards.
17664e179ddaSchristos
17674e179ddaSchristosNormal Changes
17684e179ddaSchristos==============
17694e179ddaSchristos
17704e179ddaSchristos* Fix crash due to uninitialized lastwp member of layout_cell
17714e179ddaSchristos* Fix -fg/-bg/-style with 256 colour terminals.
17724e179ddaSchristos
1773c9ad075bSchristosCHANGES FROM 1.8 TO 1.9, 20 February 2014
17744e179ddaSchristos
17754e179ddaSchristosNOTE:  This release has bumped the tmux protocol version.  It is therefore
17764e179ddaSchristosadvised that the prior tmux server is restarted when this version of tmux is
17774e179ddaSchristosinstalled, to avoid protocol mismatch errors for newer clients trying to
17784e179ddaSchristostalk to an older running tmux server.
17794e179ddaSchristos
17804e179ddaSchristosIncompatible Changes
17814e179ddaSchristos====================
17824e179ddaSchristos
17834e179ddaSchristos* 88 colour support has been removed.
17844e179ddaSchristos* 'default-path' has been removed.  The new-window command accepts '-c' to
17854e179ddaSchristos  cater for this.  The previous value of "." can be replaced with: 'neww -c
17864e179ddaSchristos  $PWD', the previous value of '' which meant current path of the pane can
17874e179ddaSchristos  be specified as:  'neww -c "#{pane_current_path}"'
17884e179ddaSchristos
17894e179ddaSchristosDeprecated Changes
17904e179ddaSchristos==================
17914e179ddaSchristos
17924e179ddaSchristos* The single format specifiers:  #A -> #Z (where defined) have been
17934e179ddaSchristos  deprecated and replaced with longer-named equivalents, as listed in the
17944e179ddaSchristos  FORMATS section of the tmux manpage.
17954e179ddaSchristos* The various foo-{fg,bg,attr} commands have been deprecated and replaced
17964e179ddaSchristos  with equivalent foo-style option instead.  Currently this is still
17974e179ddaSchristos  backwards-compatible, but will be removed over time.
17984e179ddaSchristos
17994e179ddaSchristosNormal Changes
18004e179ddaSchristos==============
18014e179ddaSchristos
18024e179ddaSchristos* A new environment variable TMUX_TMPDIR is now honoured, allowing the
18034e179ddaSchristos  socket directory to be set outside of TMPDIR (/tmp/ if not set).
18044e179ddaSchristos* If -s not given to swap-pane the current pane is assumed.
18054e179ddaSchristos* A #{pane_synchronized} format specifier has been added to be a conditional
18064e179ddaSchristos  format if a pane is in a synchronised mode (c.f. synchronize-panes)
18074e179ddaSchristos* Tmux now runs under Cygwin natively.
18084e179ddaSchristos* Formats can now be nested within each other and expanded accordingly.
18094e179ddaSchristos* Added 'automatic-rename-format' option to allow the automatic rename
18104e179ddaSchristos  mechanism to use something other than the default of
18114e179ddaSchristos  #{pane_current_command}.
18124e179ddaSchristos* new-session learnt '-c' to specify the starting directory for that session
18134e179ddaSchristos  and all subsequent windows therein.
18144e179ddaSchristos* The session name is now shown in the message printed to the terminal when
18154e179ddaSchristos  a session is detached.
18164e179ddaSchristos* Lots more format specifiers have been added.
18174e179ddaSchristos* Server race conditions have been fixed; in particular commands are not run
18184e179ddaSchristos  until after the configuration file is read completely.
18194e179ddaSchristos* Case insensitive searching in tmux's copy-mode is now possible.
18204e179ddaSchristos* attach-session and switch-client learnt the '-t' option to accept a window
18214e179ddaSchristos  and/or a pane to use.
18224e179ddaSchristos* Copy-mode is only exited if no selection is in progress.
18234e179ddaSchristos* Paste key in copy-mode is now possible to enter text from the clipboard.
18244e179ddaSchristos* status-interval set to '0' now works as intended.
18254e179ddaSchristos* tmux now supports 256 colours running under fbterm.
18264e179ddaSchristos* Many bug fixes!
18274e179ddaSchristos
1828c9ad075bSchristosCHANGES FROM 1.7 TO 1.8, 26 March 2013
18294e179ddaSchristos
18304e179ddaSchristosIncompatible Changes
18314e179ddaSchristos====================
18324e179ddaSchristos
18334e179ddaSchristos* layout redo/undo has been removed.
18344e179ddaSchristos
18354e179ddaSchristosNormal Changes
18364e179ddaSchristos==============
18374e179ddaSchristos
18384e179ddaSchristos* Add halfpage up/down bindings to copy mode.
18394e179ddaSchristos* Session choosing fixed to work with unattached sessions.
18404e179ddaSchristos* New window options window-status-last-{attr,bg,fg} to denote the last
18414e179ddaSchristos  window which was active.
18424e179ddaSchristos* Scrolling in copy-mode now scrolls the region without moving the mouse
18434e179ddaSchristos  cursor.
18444e179ddaSchristos* run-shell learnt '-t' to specify the pane to use when displaying output.
18454e179ddaSchristos* Support for middle-click pasting.
18464e179ddaSchristos* choose-tree learns '-u' to start uncollapsed.
18474e179ddaSchristos* select-window learnt '-T' to toggle to the last window if it's already
18484e179ddaSchristos  current.
18494e179ddaSchristos* New session option 'assume-paste-time' for pasting text versus key-binding
18504e179ddaSchristos  actions.
18514e179ddaSchristos* choose-* commands now work outside of an attached client.
18524e179ddaSchristos* Aliases are now shown for list-commands command.
18534e179ddaSchristos* Status learns about formats.
18544e179ddaSchristos* Free-form options can be set with set-option if prepended with an '@'
18554e179ddaSchristos  sign.
18564e179ddaSchristos* capture-pane learnt '-p' to send to stdout, and '-e' for capturing escape
18574e179ddaSchristos  sequences, and '-a' to capture the alternate screen, and '-P' to dump
18584e179ddaSchristos  pending output.
18594e179ddaSchristos* Many new formats added (client_session, client_last_session, etc.)
18604e179ddaSchristos* Control mode, which is a way for a client to send tmux commands.
18614e179ddaSchristos  Currently more useful to users of iterm2.
18624e179ddaSchristos* resize-pane learnt '-x' and '-y' for absolute pane sizing.
18634e179ddaSchristos* Config file loading now reports errors from all files which are loaded via
18644e179ddaSchristos  the 'source-file' command.
18654e179ddaSchristos* 'copy-pipe' mode command to copy selection and pipe the selection to a
18664e179ddaSchristos  command.
18674e179ddaSchristos* Panes can now emit focus notifications for certain applications
18684e179ddaSchristos  which use those.
18694e179ddaSchristos* run-shell and if-shell now accept formats.
18704e179ddaSchristos* resize-pane learnt '-Z' for zooming a pane temporarily.
18714e179ddaSchristos* new-session learnt '-A' to make it behave like attach-session.
18724e179ddaSchristos* set-option learnt '-o' to prevent setting an option which is already set.
18734e179ddaSchristos* capture-pane and show-options learns '-q' to silence errors.
18744e179ddaSchristos* New command 'wait-for' which blocks a client until woken up again.
18754e179ddaSchristos* Resizing panes will now reflow the text inside them.
18764e179ddaSchristos* Lots and lots of bug fixes, fixing memory-leaks, etc.
18774e179ddaSchristos* Various manpage improvements.
18784e179ddaSchristos
1879c9ad075bSchristosCHANGES FROM 1.6 TO 1.7, 13 October 2012
18804e179ddaSchristos
18814e179ddaSchristos* tmux configuration files now support line-continuation with a "\" at the
18824e179ddaSchristos  end of a line.
18834e179ddaSchristos* New option status-position to move the status line to the top or bottom of
18844e179ddaSchristos  the screen.
18854e179ddaSchristos* Enforce history-limit option when clearing the screen.
18864e179ddaSchristos* Give each window a unique id, like panes but prefixed with @.
18874e179ddaSchristos* Add pane id to each pane in layout description (while still accepting
18884e179ddaSchristos  the old form).
18894e179ddaSchristos* Provide defined ways to set the various default-path possibilities: ~
18904e179ddaSchristos  for home directory, . for server start directory, - for session start
18914e179ddaSchristos  directory and empty for the pane's working directory (the default). All
18924e179ddaSchristos  can also be used as part of a relative path (eg -/foo). Also provide -c
18934e179ddaSchristos  flags to neww and splitw to override default-path setting.
18944e179ddaSchristos* Add -l flag to send-keys to send input literally (without translating
18954e179ddaSchristos  key names).
18964e179ddaSchristos* Allow a single option to be specified to show-options to show just that
18974e179ddaSchristos  option.
18984e179ddaSchristos* New command "move-pane" (like join-pane but allows the same window).
18994e179ddaSchristos* join-pane and move-pane commands learn "-b" option to place the pane to
19004e179ddaSchristos  the left or above.
19014e179ddaSchristos* Support for bracketed-paste mode.
19024e179ddaSchristos* Allow send-keys command to accept hex values.
19034e179ddaSchristos* Add locking around "start-server" to avoid race-conditions.
19044e179ddaSchristos* break-pane learns -P/-F arguments for display formatting.
19054e179ddaSchristos* set-option learns "-q" to make it quiet, and not print out anything.
19064e179ddaSchristos* copy mode learns "wrap-search" option.
19074e179ddaSchristos* Add a simple form of output rate limiting by counting the number of
19084e179ddaSchristos  certain C0 sequences (linefeeds, backspaces, carriage returns) and if it
19094e179ddaSchristos  exceeds a threshold (current default 250/millisecond), start to redraw
19104e179ddaSchristos  the pane every 100 milliseconds instead of making each change as it
19114e179ddaSchristos  comes. Two configuration options - c0-change-trigger and
19124e179ddaSchristos  c0-change-interval.
19134e179ddaSchristos* find-window learns new flags:  "-C", "-N", "-T" to match against either or
19144e179ddaSchristos  all of a window's content, name, or title.  Defaults to all three options
19154e179ddaSchristos  if none specified.
19164e179ddaSchristos* find-window automatically selects the appropriate pane for the found
19174e179ddaSchristos  matches.
19184e179ddaSchristos* show-environment can now accept one option to show that environment value.
19194e179ddaSchristos* Exit mouse mode when end-of-screen reached when scrolling with the mouse
19204e179ddaSchristos  wheel.
19214e179ddaSchristos* select-layout learns -u and -U for layout history stacks.
19224e179ddaSchristos* kill-window, detach-client, kill-session all  learn "-a" option for
19234e179ddaSchristos  killing all but the current thing specified.
19244e179ddaSchristos* move-window learns "-r" option to renumber window sequentially in a
19254e179ddaSchristos  session.
19264e179ddaSchristos* New session option "renumber-windows" to automatically renumber windows in
19274e179ddaSchristos  a session when a window is closed.  (see "move-window -r").
19284e179ddaSchristos* Only enter copy-mode on scroll up.
19294e179ddaSchristos* choose-* and list-* commands all use "-F" for format specifiers.
19304e179ddaSchristos* When spawning external commands, the value from the "default-shell" option
19314e179ddaSchristos  is now used, rather than assuming /bin/sh.
19324e179ddaSchristos* New choose-tree command to render window/sessions as a tree for selection.
19334e179ddaSchristos* display-message learns new format options.
19344e179ddaSchristos* For linked-windows across sessions, all flags for that window are now
19354e179ddaSchristos  cleared across sessions.
19364e179ddaSchristos* Lots and lots of bug fixes, fixing memory-leaks, etc.
19374e179ddaSchristos* Various manpage improvements.
19384e179ddaSchristos
19394e179ddaSchristosCHANGES FROM 1.5 TO 1.6, 23 January 2012
19404e179ddaSchristos
19414e179ddaSchristos* Extend the mode-mouse option to add a third choice which means the mouse
19424e179ddaSchristos  does not enter copy mode.
19434e179ddaSchristos* Add a -r flag to switch-client to toggle the client read-only flag.
19444e179ddaSchristos* Add pane-base-index option.
19454e179ddaSchristos* Support \ for line continuation in the configuration file.
19464e179ddaSchristos* Framework for more powerful formatting of command output and use it for
19474e179ddaSchristos  list-{panes,windows,sessions}. This allows more descriptive replacements
19484e179ddaSchristos  (such as #{session_name}) and conditionals.
19494e179ddaSchristos* Mark dead panes with some text saying they are dead.
19504e179ddaSchristos* Reject $SHELL if it is not a full path.
19514e179ddaSchristos* Add -S option to refresh-client to redraw status line.
19524e179ddaSchristos* Add an else clause for if-shell.
19534e179ddaSchristos* Try to resolve relative paths for loadb and saveb (first, using client
19544e179ddaSchristos  working directory, if any, then default-path or session working directory).
19554e179ddaSchristos* Support for \e[3J to clear the history and send the corresponding
19564e179ddaSchristos  terminfo code (E3) before locking.
19574e179ddaSchristos* When in copy mode, make repeat count indicate buffer to replace, if used.
19584e179ddaSchristos* Add screen*:XT to terminal-overrides for tmux-in-tmux.
19594e179ddaSchristos* Status-line message attributes added.
19604e179ddaSchristos* Move word-separators to be a session rather than window option.
19614e179ddaSchristos* Change the way the working directory for new processes is discovered. If
19624e179ddaSchristos  default-path isn't empty, it is used. Otherwise, if a new window is created
19634e179ddaSchristos  from the command-line, the working directory of the client is used. If not,
19644e179ddaSchristos  platform specific code is used to retrieve the current working directory
19654e179ddaSchristos  of the process in the active pane. If that fails, the directory where the
19664e179ddaSchristos  session was created is used, instead.
19674e179ddaSchristos* Do not change the current pane if both mouse-select-{pane,window} are
19684e179ddaSchristos  enabled.
19694e179ddaSchristos* Add \033[s and \033[u to save and restore cursor position.
19704e179ddaSchristos* Allow $HOME to be used as default-path.
19714e179ddaSchristos* Add CNL and CPL escape sequences.
19724e179ddaSchristos* Calculate last position correctly for UTF-8 wide characters.
19734e179ddaSchristos* Add an option allow-rename to disable the window rename escape sequence.
19744e179ddaSchristos* Attributes for each type of status-line alert (ie bell, content and
19754e179ddaSchristos  activity) added. Therefore, remove the superfluous options
19764e179ddaSchristos  window-status-alert-{attr,bg,fg}.
19774e179ddaSchristos* Add a -R flag to send-keys to reset the terminal.
19784e179ddaSchristos* Add strings to allow the aixterm bright colours to be used when
19794e179ddaSchristos  configuring colours.
19804e179ddaSchristos* Drop the ability to have a list of keys in the prefix in favour of two
19814e179ddaSchristos  separate options, prefix and prefix2.
19824e179ddaSchristos* Flag -2 added to send-prefix to send the secondary prefix key.
19834e179ddaSchristos* Show pane size in top right of display panes mode.
19844e179ddaSchristos* Some memory leaks plugged.
19854e179ddaSchristos* More command-prompt editing improvements.
19864e179ddaSchristos* Various manpage improvements.
19874e179ddaSchristos* More Vi mode improvements.
19884e179ddaSchristos
19894e179ddaSchristosCHANGES FROM 1.4 TO 1.5, 09 July 2011
19904e179ddaSchristos
19914e179ddaSchristos* Support xterm mouse modes 1002 and 1003.
19924e179ddaSchristos* Change from a per-session stack of buffers to one global stack. This renders
19934e179ddaSchristos  copy-buffer useless and makes buffer-limit now a server option.
19944e179ddaSchristos* Fix most-recently-used choice by avoiding reset the activity timer for
19954e179ddaSchristos  unattached sessions every second.
19964e179ddaSchristos* Add a -P option to new-window and split-window to print the new window or
19974e179ddaSchristos  pane index in target form (useful to pass it into other commands).
19984e179ddaSchristos* Handle a # at the end of a replacement string (such as status-left)
19994e179ddaSchristos  correctly.
20004e179ddaSchristos* Support for UTF-8 mouse input (\033[1005h) which was added in xterm 262.
20014e179ddaSchristos  If the new mouse-utf8 option is on, UTF-8 mouse input is enabled for all
20024e179ddaSchristos  UTF-8 terminals. The option defaults to on if LANG etc are set in the same
20034e179ddaSchristos  manner as the utf8 option.
20044e179ddaSchristos* Support for HP-UX.
20054e179ddaSchristos* Accept colours of the hex form #ffffff and translate to the nearest from the
20064e179ddaSchristos  xterm(1) 256-colour set.
20074e179ddaSchristos* Clear the non-blocking IO flag (O_NONBLOCK) on the stdio file descriptors
20084e179ddaSchristos  before closing them (fixes things like "tmux ls && cat").
20094e179ddaSchristos* Use TMPDIR if set.
20104e179ddaSchristos* Fix next and previous session functions to actually work.
20114e179ddaSchristos* Support -x and -y for new-session to specify the initial size of the window
20124e179ddaSchristos  if created detached with -d.
20134e179ddaSchristos* Make bind-key accept characters with the top-bit-set and print them as octal.
20144e179ddaSchristos* Set $TMUX without the session when background jobs are run.
20154e179ddaSchristos* Simplify the way jobs work and drop the persist type, so all jobs are
20164e179ddaSchristos  fire-and-forget.
20174e179ddaSchristos* Accept tcgetattr/tcsetattr(3) failure, fixes problems with fatal() if the
20184e179ddaSchristos  terminal disappears while locked.
20194e179ddaSchristos* Add a -P option to detach to HUP the client's parent process (usually causing
20204e179ddaSchristos  it to exit as well).
20214e179ddaSchristos* Support passing through escape sequences to the underlying terminal by using
20224e179ddaSchristos  DCS with a "tmux;" prefix.
20234e179ddaSchristos* Prevent tiled producing a corrupt layout when only one column is needed.
20244e179ddaSchristos* Give each pane created in a tmux server a unique id (starting from 0), put it
20254e179ddaSchristos  in the TMUX_PANE environment variable and accept it as a target.
20264e179ddaSchristos* Allow a start and end line to be specified for capture-pane which may be
20274e179ddaSchristos  negative to capture part of the history.
20284e179ddaSchristos* Add -a and -s options to lsp to list all panes in the server or session
20294e179ddaSchristos  respectively. Likewise add -s to lsw.
20304e179ddaSchristos* Change -t on display-message to be target-pane for the #[A-Z] replacements
20314e179ddaSchristos  and add -c as target-client.
20324e179ddaSchristos* The attach-session command now prefers the most recently used unattached
20334e179ddaSchristos  session.
20344e179ddaSchristos* Add -s option to detach-client to detach all clients attached to a session.
20354e179ddaSchristos* Add -t to list-clients.
20364e179ddaSchristos* Change window with mouse wheel over status line if mouse-select-window is on.
20374e179ddaSchristos* When mode-mouse is on, automatically enter copy mode when the mouse is
20384e179ddaSchristos  dragged or the mouse wheel is used. Also exit copy mode when the mouse wheel
20394e179ddaSchristos  is scrolled off the bottom.
20404e179ddaSchristos* Provide #h character pair for short hostname (no domain).
20414e179ddaSchristos* Don't use strnvis(3) for the title as it breaks UTF-8.
20424e179ddaSchristos* Use the tsl and fsl terminfo(5) capabilities to update terminal title and
20434e179ddaSchristos  automatically fill them in on terminals with the XT capability (which means
20444e179ddaSchristos  their title setting is xterm-compatible).
20454e179ddaSchristos* Add a new option, mouse-resize-pane. When on, panes may be resized by
20464e179ddaSchristos  dragging their borders.
20474e179ddaSchristos* Fix crash by resetting last pane on {break,swap}-pane across windows.
20484e179ddaSchristos* Add three new copy-mode commands - select-line, copy-line, copy-end-of-line.
20494e179ddaSchristos* Support setting the xterm clipboard when copying from copy mode using the
20504e179ddaSchristos  xterm escape sequence for the purpose (if xterm is configured to allow it).
20514e179ddaSchristos* Support xterm(1) cursor colour change sequences through terminfo(5) Cc
20524e179ddaSchristos  (set) and Cr (reset) extensions.
20534e179ddaSchristos* Support DECSCUSR sequence to set the cursor style with two new terminfo(5)
20544e179ddaSchristos  extensions, Cs and Csr.
20554e179ddaSchristos* Make the command-prompt custom prompts recognize the status-left option
20564e179ddaSchristos  character pairs.
20574e179ddaSchristos* Add a respawn-pane command.
20584e179ddaSchristos* Add a couple of extra xterm-style keys that gnome terminal provides.
20594e179ddaSchristos* Allow the initial context on prompts to be set with the new -I option to
20604e179ddaSchristos  command-prompt. Include the current window and session name in the prompt
20614e179ddaSchristos  when renaming and add a new key binding ($) for rename session.
20624e179ddaSchristos* Option bell-on-alert added to trigger the terminal bell when there is an
20634e179ddaSchristos  alert.
20644e179ddaSchristos* Change the list-keys format so that it shows the keys using actual tmux
20654e179ddaSchristos  commands which should be able to be directly copied into the config file.
20664e179ddaSchristos* Show full targets for lsp/lsw -a.
20674e179ddaSchristos* Make confirm-before prompt customizable with -p option like command-prompt
20684e179ddaSchristos  and add the character pairs #W and #P to the default kill-{pane,window}
20694e179ddaSchristos  prompts.
20704e179ddaSchristos* Avoid sending data to suspended/locked clients.
20714e179ddaSchristos* Small memory leaks in error paths plugged.
20724e179ddaSchristos* Vi mode improvements.
20734e179ddaSchristos
20744e179ddaSchristosCHANGES FROM 1.3 TO 1.4, 27 December 2010
20754e179ddaSchristos
20764e179ddaSchristos* Window bell reporting fixed.
20774e179ddaSchristos* Show which pane is active in the list-panes output.
20784e179ddaSchristos* Backoff reworked.
20794e179ddaSchristos* Prevent the server from dying when switching into copy mode when already
20804e179ddaSchristos  in a different mode.
20814e179ddaSchristos* Reset running jobs when the status line is enabled or disabled.
20824e179ddaSchristos* Simplify xterm modifier detection.
20834e179ddaSchristos* Avoid crashing in copy mode if the screen size is too small for the
20844e179ddaSchristos  indicator.
20854e179ddaSchristos* Flags -n and -p added to switch-client.
20864e179ddaSchristos* Use UTF-8 line drawing characters on UTF-8 terminals, thus fixing some
20874e179ddaSchristos  terminals (eg putty) which disable the vt100 ACS mode switching sequences
20884e179ddaSchristos  in UTF-8 mode. On terminals without ACS, use ASCII equivalents.
20894e179ddaSchristos* New server option exit-unattached added.
20904e179ddaSchristos* New session option destroy-unattached added.
20914e179ddaSchristos* Fall back on normal session choice method if $TMUX exists but is invalid
20924e179ddaSchristos  rather than rejecting.
20934e179ddaSchristos* Mark repeating keys with "(repeat)" in the key list.
20944e179ddaSchristos* When removing a pane, don't change the active pane unless the active pane
20954e179ddaSchristos  is actually the one being removed.
20964e179ddaSchristos* New command last-pane added.
20974e179ddaSchristos* AIX fixes.
20984e179ddaSchristos* Flag -a added to unbind-key.
20994e179ddaSchristos* Add XAUTHORITY to update-environment.
21004e179ddaSchristos* More info regarding window and pane flags is now shown in list-*.
21014e179ddaSchristos* If VISUAL or EDITOR contains "vi" configure mode-keys and status-key to vi.
21024e179ddaSchristos* New window option monitor-silence and session option visual-silence added.
21034e179ddaSchristos* In the built-in layouts distribute the panes more evenly.
21044e179ddaSchristos* Set the default value of main-pane-width to 80 instead of 81.
21054e179ddaSchristos* Command-line flag -V added.
21064e179ddaSchristos* Instead of keeping a per-client prompt history make it global.
21074e179ddaSchristos* Fix rectangle copy to behave like emacs (the cursor is not part of the
21084e179ddaSchristos  selection on the right edge but on the left it is).
21094e179ddaSchristos* Flag -l added to switch-client.
21104e179ddaSchristos* Retrieve environment variables from the global environment rather than
21114e179ddaSchristos  getenv(3), thus allowing them to be updated during the configuration file.
21124e179ddaSchristos* New window options other-pane-{height,width} added.
21134e179ddaSchristos* More minor bugs fixed and manpage improvements.
21144e179ddaSchristos
21154e179ddaSchristosCHANGES FROM 1.2 TO 1.3, 18 July 2010
21164e179ddaSchristos
21174e179ddaSchristos* New input parser.
21184e179ddaSchristos* Flags to move through panes -UDLR added to select-pane.
21194e179ddaSchristos* Commands up-pane, and down-pane removed, since equivalent behaviour is now
21204e179ddaSchristos  available through the target flag (-t:+ and -t:-).
21214e179ddaSchristos* Jump-forward/backward in copy move (based on vi's F, and f commands).
21224e179ddaSchristos* Make paste-buffer accept a pane as a target.
21234e179ddaSchristos* Flag -a added to new-window to insert a window after an existing one, moving
21244e179ddaSchristos  windows up if necessary.
21254e179ddaSchristos* Merge more mode into copy mode.
21264e179ddaSchristos* Run job commands explicitly in the global environment (which can be modified
21274e179ddaSchristos  with setenv -g), rather than with the environment tmux started with.
21284e179ddaSchristos* Use the machine's hostname as the default title, instead of an empty string.
21294e179ddaSchristos* Prevent double free if the window option remain-on-exit is set.
21304e179ddaSchristos* Key string conversions rewritten.
21314e179ddaSchristos* Mark zombie windows as dead in the choose-window list.
21324e179ddaSchristos* Tiled layout added.
21334e179ddaSchristos* Signal handling reworked.
21344e179ddaSchristos* Reset SIGCHLD after fork to fix problems with some shells.
21354e179ddaSchristos* Select-prompt command removed. Therefore, bound ' to command-prompt -p index
21364e179ddaSchristos  "select-window -t:%%" by default.
21374e179ddaSchristos* Catch SIGHUP and terminate if running as a client, thus avoiding clients from
21384e179ddaSchristos  being left hanging around when, for instance, a SSH session is disconnected.
21394e179ddaSchristos* Solaris 9 fixes (such as adding compat {get,set}env(3) code).
21404e179ddaSchristos* Accept none instead of default for attributes.
21414e179ddaSchristos* Window options window-status-alert-{alert,bg,fg} added.
21424e179ddaSchristos* Flag -s added to the paste-buffer command to specify a custom separator.
21434e179ddaSchristos* Allow dragging to make a selection in copy mode if the mode-mouse option is
21444e179ddaSchristos  set.
21454e179ddaSchristos* Support the mouse scroll wheel.
21464e179ddaSchristos* Make pipe-pane accept special character sequences (eg #I).
21474e179ddaSchristos* Fix problems with window sizing when starting tmux from .xinitrc.
21484e179ddaSchristos* Give tmux sockets (but not the containing folder) group permissions.
21494e179ddaSchristos* Extend the target flags (ie -t) to accept an offset (for example -t:+2), and
21504e179ddaSchristos  make it wrap windows, and panes.
21514e179ddaSchristos* New command choose-buffer added.
21524e179ddaSchristos* New server option detach-on-destroy to set what happens to a client when the
21534e179ddaSchristos  session it is attached to is destroyed. If on (default), the client is
21544e179ddaSchristos  detached. Otherwise, the client is switched to the most recently active of
21554e179ddaSchristos  the remaining sessions.
21564e179ddaSchristos* The commands load-buffer, and save-buffer now accept a dash (-) as the file
21574e179ddaSchristos  to read from stdin, or write to stdout.
21584e179ddaSchristos* Custom layouts added.
21594e179ddaSchristos* Additional code reduction, bug fixes, and manpage enhancements.
21604e179ddaSchristos
21614e179ddaSchristosCHANGES FROM 1.1 TO 1.2, 10 March 2010
21624e179ddaSchristos
21634e179ddaSchristos* Switch to libevent.
21644e179ddaSchristos* Emulate the ri (reverse index) capability, ergo allowing tmux to at least
21654e179ddaSchristos  start on Sun consoles (TERM=sun, or sun-color).
21664e179ddaSchristos* Assign each entry a number, or lowercase letter in choose mode, and accept
21674e179ddaSchristos  that as a shortcut key.
21684e179ddaSchristos* Permit top-bit-set characters to be entered in the status line.
21694e179ddaSchristos* Mark no-prefix keys with (no prefix), rather than [] in list-keys.
21704e179ddaSchristos* New command show-messages (alias showmsgs), and new session option
21714e179ddaSchristos  message-limit, to show a per-client log of status lines messages up to the
21724e179ddaSchristos  number defined by message-limit.
21734e179ddaSchristos* Do not interpret #() for display-message to avoid leaking commands.
21744e179ddaSchristos* New window options window-status-format, and window-status-current-format to
21754e179ddaSchristos  control the format of each window in the status line.
21764e179ddaSchristos* Add a -p flag to display-message to print the output, instead of displaying
21774e179ddaSchristos  it in the status line.
21784e179ddaSchristos* Emulate il1, dl1, ich1 to run with vt100 feature set.
21794e179ddaSchristos* New command capture-pane (alias capturep) to copy the entire pane contents
21804e179ddaSchristos  to a paste buffer.
21814e179ddaSchristos* Avoid duplicating code by adding a -w flag to set-option, and show-options to
21824e179ddaSchristos  set, and show window options. The commands set-window-option, and
21834e179ddaSchristos  show-window-options are now aliases.
21844e179ddaSchristos* Panes can now be referred to as top, bottom, top-left, etc.
21854e179ddaSchristos* Add server-wide options, which can be set with set-option -s, and shown with
21864e179ddaSchristos  show-options -s.
21874e179ddaSchristos* New server option quiet (like -q from the command line).
21884e179ddaSchristos* New server option escape-time to set the timeout used to detect if escapes
21894e179ddaSchristos  are alone, part of a function key, or meta sequence.
21904e179ddaSchristos* New session options pane-active-border-bg, pane-active-border-fg,
21914e179ddaSchristos  pane-border-bg, and pane-border-fg to set pane colours.
21924e179ddaSchristos* Make split-window accept a pane target, instead of a window.
21934e179ddaSchristos* New command join-pane (alias joinp) to split, and move an existing pane into
21944e179ddaSchristos  the space (the opposite of break-pane), thus simplifying calls to
21954e179ddaSchristos  split-window, followed by move-window.
21964e179ddaSchristos* Permit S- prefix on keys for shift when the terminal/terminfo supports them.
21974e179ddaSchristos* Window targets (-t flag) can now refer to the last window (!), next (+), and
21984e179ddaSchristos  previous (-) window by number.
21994e179ddaSchristos* Mode keys to jump to the bottom/top of history, end of the next word, scroll
22004e179ddaSchristos  up/down, and reverse search in copy mode.
22014e179ddaSchristos* New session option display-panes-active-colour to display the active pane in
22024e179ddaSchristos  a different colour with the display-panes command.
22034e179ddaSchristos* Read the socket path from $TMUX if it's present, and -L, and -S are not
22044e179ddaSchristos  given.
22054e179ddaSchristos* Vi-style mode keys B, W, and E to navigate between words in copy mode.
22064e179ddaSchristos* Start in more mode when configuration file errors are detected.
22074e179ddaSchristos* Rectangle copy support added.
22084e179ddaSchristos* If attach-session was specified with the -r flag, make the client read-only.
22094e179ddaSchristos* Per-window alternate-screen option.
22104e179ddaSchristos* Make load-buffer work with FIFOs.
22114e179ddaSchristos* New window option word-separators to set the characters considered as word
22124e179ddaSchristos  separators in copy mode.
22134e179ddaSchristos* Permit keys in copy mode to be prefixed by a repeat count, entered with [1-9]
22144e179ddaSchristos  in vi mode, or M-[1-9] in emacs mode.
22154e179ddaSchristos* utf8 improvements.
22164e179ddaSchristos* As usual, additional code reduction, bug fixes, and manpage enhancements.
22174e179ddaSchristos
22184e179ddaSchristosCHANGES FROM 1.0 TO 1.1, 05 November 2009
22194e179ddaSchristos
22204e179ddaSchristos* New run-shell (alias run) command to run an external command without a
22214e179ddaSchristos  window, capture it's stdout, and send it to output mode.
22224e179ddaSchristos* Ability to define multiple prefix keys.
22234e179ddaSchristos* Internal locking mechanism removed. Instead, detach each client and run the
22244e179ddaSchristos  external command specified in the new session option lock-command (by default
22254e179ddaSchristos  lock -np), thus allowing the system password to be used.
22264e179ddaSchristos* set-password command, and -U command line flag removed per the above change.
22274e179ddaSchristos* Add support for -c command line flag to execute a shell command.
22284e179ddaSchristos* New lock-client (alias lockc), and lock-session (alias locks) commands to
22294e179ddaSchristos  lock a particular client, or all clients attached to a session.
22304e179ddaSchristos* Support C-n/C-p/C-v/M-v with emacs keys in choice mode.
22314e179ddaSchristos* Use : for goto line rather than g in vi mode.
22324e179ddaSchristos* Try to guess which client to use when no target client was specified. Finds
22334e179ddaSchristos  the current session, and if only one client is present, use it. Otherwise,
22344e179ddaSchristos  return the most recently used client.
22354e179ddaSchristos* Make C-Down/C-Up in copy mode scroll the screen down/up one line without
22364e179ddaSchristos  moving the cursor.
22374e179ddaSchristos* Scroll mode superseded by copy mode.
22384e179ddaSchristos* New synchronize-panes window option to send all input to all other panes in
22394e179ddaSchristos  the same window.
22404e179ddaSchristos* New lock-server session option to lock, when off (on by default), each
22414e179ddaSchristos  session when it has been idle for the lock-after-time setting. When on, the
22424e179ddaSchristos  entire server locks when all sessions have been idle for their individual
22434e179ddaSchristos  lock-after-time setting.
22444e179ddaSchristos* Add support for grouped sessions which have independent name, options,
22454e179ddaSchristos  current window, but where the linked windows are synchronized (ie creating,
22464e179ddaSchristos  killing windows are mirrored between the sessions). A grouped session may be
22474e179ddaSchristos  created by passing -t to new-session.
22484e179ddaSchristos* New mouse-select-pane session option to select the current pane with the
22494e179ddaSchristos  mouse.
22504e179ddaSchristos* Queue, and run commands in the background for if-shell, status-left,
22514e179ddaSchristos  status-right, and #() by starting each once every status-interval. Adds the
22524e179ddaSchristos  capability to call some programs which would previously cause the server to
22534e179ddaSchristos  hang (eg sleep/tmux). It also avoids running commands excessively (ie if used
22544e179ddaSchristos  multiple times, it will be run only once).
22554e179ddaSchristos* When a window is zombified and automatic-rename is on, append [dead] to the
22564e179ddaSchristos  name.
22574e179ddaSchristos* Split list-panes (alias lsp) off from list-windows.
22584e179ddaSchristos* New pipe-pane (alias pipep) to redirect a pane output to an external command.
22594e179ddaSchristos* Support for automatic-renames for Solaris.
22604e179ddaSchristos* Permit attributes to be turned off in #[] by prefixing with no (eg nobright).
22614e179ddaSchristos* Add H/M/L in vi mode, and M-R/M-r in emacs to move the cursor to the top,
22624e179ddaSchristos  middle, and bottom of the screen.
22634e179ddaSchristos* -a option added to kill-pane to kill all except current pane.
22644e179ddaSchristos* The -d command line flag is now gone (can be replaced by terminal-overrides).
22654e179ddaSchristos  Just use op/AX to detect default colours.
22664e179ddaSchristos* input/tty/utf8 improvements.
22674e179ddaSchristos* xterm-keys rewrite.
22684e179ddaSchristos* Additional code reduction, and bug fixes.
22694e179ddaSchristos
2270c9ad075bSchristosCHANGES FROM 0.9 TO 1.0, 20 September 2009
22714e179ddaSchristos
22724e179ddaSchristos* Option to alter the format of the window title set by tmux.
22734e179ddaSchristos* Backoff for a while after multiple incorrect password attempts.
22744e179ddaSchristos* Quick display of pane numbers (C-b q).
22754e179ddaSchristos* Better choose-window, choose-session commands and a new choose-client command.
22764e179ddaSchristos* Option to request multiple responses when using command-prompt.
22774e179ddaSchristos* Improved environment handling.
22784e179ddaSchristos* Combine wrapped lines when pasting.
22794e179ddaSchristos* Option to override terminal settings (terminal-overrides).
22804e179ddaSchristos* Use the full range of ACS characters for drawing pane separator lines.
22814e179ddaSchristos* Customisable mode keys.
22824e179ddaSchristos* Status line colour options, with embedded colours in status-left/right, and
22834e179ddaSchristos  an option to centre the window list.
22844e179ddaSchristos* Much improved layouts, including both horizontal and vertical splitting.
22854e179ddaSchristos* Optional visual bell, activity and content indications.
22864e179ddaSchristos* Set the utf8 and status-utf8 options when the server is started with -u.
22874e179ddaSchristos* display-message command to show a message in the status line, by default some
22884e179ddaSchristos  information about the current window.
22894e179ddaSchristos* Improved current process detection on NetBSD.
22904e179ddaSchristos* unlink-window -k is now the same as kill-window.
22914e179ddaSchristos* attach-session now works from inside tmux.
22924e179ddaSchristos* A system-wide configuration file, /etc/tmux.conf.
22934e179ddaSchristos* A number of new commands in copy mode, including searching.
22944e179ddaSchristos* Panes are now specified using the target (-t) notation.
22954e179ddaSchristos* -t now accepts fnmatch(3) patterns and looks for prefixes.
22964e179ddaSchristos* Translate \r into \n when pasting.
22974e179ddaSchristos* Support for binding commands to keys without the prefix key
22984e179ddaSchristos* Support for alternate screen (terminfo smcup/rmcup).
22994e179ddaSchristos* Maintain data that goes off screen after reducing the window size, so it can
23004e179ddaSchristos  be restored when the size is increased again.
23014e179ddaSchristos* New if-shell command to test a shell command before running a tmux command.
23024e179ddaSchristos* tmux now works as the shell.
23034e179ddaSchristos* Man page reorganisation.
23044e179ddaSchristos* Many minor additions, much code tidying and several bug fixes.
23054e179ddaSchristos
23064e179ddaSchristosCHANGES FROM 0.8 TO 0.9, 01 July 2009
23074e179ddaSchristos
23084e179ddaSchristos* Major changes to build infrastructure: cleanup of makefiles and addition
23094e179ddaSchristos  of a configure script.
23104e179ddaSchristos* monitor-content window option to monitor a window for a specific fnmatch(3)
23114e179ddaSchristos  pattern. The find-window command also now accepts fnmatch(3) patterns.
23124e179ddaSchristos* previous-layout and select-layout commands, and a main-horizontal layout.
23134e179ddaSchristos* Recreate the server socket on SIGUSR1.
23144e179ddaSchristos* clear-history command.
23154e179ddaSchristos* Use ACS line drawing characters for pane separator lines.
23164e179ddaSchristos* UTF-8 improvements, and code to detect UTF-8 support by looking at
23174e179ddaSchristos  environment variables.
23184e179ddaSchristos* The resize-pane-up and resize-pane-down commands are now merged together
23194e179ddaSchristos  into a new resize-pane command with -U and -D flags.
23204e179ddaSchristos* confirm-before command to request a yes/no answer before executing dangerous
23214e179ddaSchristos  commands.
23224e179ddaSchristos* Status line bug fixes, support for UTF-8 (status-utf8 option), and a key to
23234e179ddaSchristos  paste from the paste buffer.
23244e179ddaSchristos* Support for some additional escape sequences and terminal features, including
23254e179ddaSchristos  better support for insert mode and tab stops.
23264e179ddaSchristos* Improved window resizing behaviour, modelled after xterm.
23274e179ddaSchristos* Some code reduction and a number of miscellaneous bug fixes.
23284e179ddaSchristos
23294e179ddaSchristos================================================================================
23304e179ddaSchristos
23314e179ddaSchristosOn 01 June 2009, tmux was imported into the OpenBSD base system. From this date
23324e179ddaSchristosonward changes are logged as part of the normal CVS commit message to either
23334e179ddaSchristosOpenBSD or SourceForge CVS. This file will be updated to contain a summary of
23344e179ddaSchristosmajor changes with each release, and to mention important configuration or
23354e179ddaSchristoscommand syntax changes during development.
23364e179ddaSchristos
23374e179ddaSchristosThe list of older changes is below.
23384e179ddaSchristos
23394e179ddaSchristos================================================================================
23404e179ddaSchristos
23414e179ddaSchristos21 May 2009
23424e179ddaSchristos
23434e179ddaSchristos* stat(2) files before trying to load them to avoid problems, for example
23444e179ddaSchristos  with "source-file /dev/zero".
23454e179ddaSchristos
23464e179ddaSchristos19 May 2009
23474e179ddaSchristos
23484e179ddaSchristos* Try to guess if the window is UTF-8 by outputting a three-byte UTF-8 wide
23494e179ddaSchristos  character and seeing how much the cursor moves. Currently tries to figure out
23504e179ddaSchristos  if this works by some stupid checks on the terminal, these need to be
23514e179ddaSchristos  rethought. Also might be better using a width 1 character rather than width 2.
23524e179ddaSchristos* If LANG contains "UTF-8", assume the terminal supports UTF-8, on the grounds
23534e179ddaSchristos  that anyone who configures it probably wants UTF-8. Not certain if this is
23544e179ddaSchristos  a perfect idea but let's see if it causes any problems.
23554e179ddaSchristos* New window option: monitor-content. Searches for a string in a window and if
23564e179ddaSchristos  it matches, highlight the status line.
23574e179ddaSchristos
23584e179ddaSchristos18 May 2009
23594e179ddaSchristos
23604e179ddaSchristos* main-horizontal layout and main-pane-height option to match vertical.
23614e179ddaSchristos* New window option main-pane-width to set the width of the large left pane with
23624e179ddaSchristos  main-vertical (was left-vertical) layout.
23634e179ddaSchristos* Lots of layout cleanup. manual layout is now manual-vertical.
23644e179ddaSchristos
23654e179ddaSchristos16 May 2009
23664e179ddaSchristos
23674e179ddaSchristos* select-layout command and a few default key bindings (M-0, M-1, M-2, M-9) to
23684e179ddaSchristos  select layouts.
23694e179ddaSchristos* Recreate server socket on SIGUSR1, per SF feature request 2792533.
23704e179ddaSchristos
23714e179ddaSchristos14 May 2009
23724e179ddaSchristos
23734e179ddaSchristos* Keys in status line (p in vi mode, M-y in emacs) to paste the first line
23744e179ddaSchristos  of the upper paste buffer. Suggested by Dan Colish.
23754e179ddaSchristos* clear-history command to clear a pane's history.
23764e179ddaSchristos* Don't force wrapping with \n when asked, let the cursor code figure it out.
23774e179ddaSchristos  Should fix terminals which use this to detect line breaks.
23784e179ddaSchristos* Major cleanup and restructuring of build infrastructure. Still separate files
23794e179ddaSchristos  for GNU and BSD make, but they are now hugely simplified at the expense of
23804e179ddaSchristos  adding a configure script which must be run before make. Now build and
23814e179ddaSchristos  install with:
23824e179ddaSchristos
23834e179ddaSchristos	$ ./configure && make && sudo make install
23844e179ddaSchristos
23854e179ddaSchristos04 May 2009
23864e179ddaSchristos
23874e179ddaSchristos* Use ACS line drawing characters for pane separator lines.
23884e179ddaSchristos
23894e179ddaSchristos30 April 2009
23904e179ddaSchristos
23914e179ddaSchristos* Support command sequences without a space before the semicolon, for example
23924e179ddaSchristos  "neww; neww" now works as well as "neww ; neww". "neww;neww" is still an
23934e179ddaSchristos  error.
23944e179ddaSchristos* previous-layout command.
23954e179ddaSchristos* Display the layout name in window lists.
23964e179ddaSchristos* Merge resize-pane-up and resize-pane-down into resize-pane with -U and -D
23974e179ddaSchristos  flags.
23984e179ddaSchristos
23994e179ddaSchristos29 April 2009
24004e179ddaSchristos
24014e179ddaSchristos* Get rid of compat/vis.* - only one function was used which is easily
24024e179ddaSchristos  replaced,and less compat code == good.
24034e179ddaSchristos
24044e179ddaSchristos27 April 2009
24054e179ddaSchristos
24064e179ddaSchristos* Avoid using the prompt history when the server is locked, and prevent any
24074e179ddaSchristos  input entered from being added to the client's prompt history.
24084e179ddaSchristos* New command, confirm-before (alias confirm), which asks for confirmation
24094e179ddaSchristos  before executing a command. Bound "&" and "x" by default to confirm-before
24104e179ddaSchristos  "kill-window" and confirm-before "kill-pane", respectively.
24114e179ddaSchristos
24124e179ddaSchristos23 April 2009
24134e179ddaSchristos
24144e179ddaSchristos* Support NEL, yet another way of making newline. Fixes the output from some
24154e179ddaSchristos  Gentoo packaging thing. Reported by someone on SF then logs that allowed a
24164e179ddaSchristos  fix sent by tcunha.
24174e179ddaSchristos* Use the xenl terminfo flag to detect early-wrap terminals like the FreeBSD
24184e179ddaSchristos  console. Many thanks for a very informative email from Christian Weisgerber.
24194e179ddaSchristos
24204e179ddaSchristos21 April 2009
24214e179ddaSchristos
24224e179ddaSchristos* tmux 0.8 released.
24234e179ddaSchristos
24244e179ddaSchristos17 April 2009
24254e179ddaSchristos
24264e179ddaSchristos* Remove the right number of characters from the buffer when escape then
24274e179ddaSchristos  a cursor key (or other key prefixed by \033) is pressed. Reported by
24284e179ddaSchristos  Stuart Henderson.
24294e179ddaSchristos
24304e179ddaSchristos03 April 2009
24314e179ddaSchristos
24324e179ddaSchristos* rotate-window command. -U flag (default) for up, -D flag for down.
24334e179ddaSchristos
24344e179ddaSchristos02 April 2009
24354e179ddaSchristos
24364e179ddaSchristos* Change scroll/pane redraws to only redraw the single pane affected rather
24374e179ddaSchristos  than the entire window.
24384e179ddaSchristos* If redrawing the region would mean redrawing > half the pane, just schedule
24394e179ddaSchristos  to redraw the entire window. Also add a flag to skip updating the window any
24404e179ddaSchristos  further if it is scheduled to be redrawn. This has the effect of batching
24414e179ddaSchristos  multiple redraws together.
24424e179ddaSchristos
24434e179ddaSchristos01 April 2009
24444e179ddaSchristos
24454e179ddaSchristos* Basic horizontal splitting and layout management. Still some redraw and other
24464e179ddaSchristos  issues - particularly, don't mix with manual pane resizing, be careful when
24474e179ddaSchristos  viewing from multiple clients and don't expect shell windows to redraw very
24484e179ddaSchristos  well after the layout is changed; generally cycling the layout a few times
24494e179ddaSchristos  will fix most problems. Getting this in for testing while I think about how
24504e179ddaSchristos  to deal with manual mode.
24514e179ddaSchristos
24524e179ddaSchristos  Split window as normal and cycle the layouts with C-b space. Some of the
24534e179ddaSchristos  layouts will work better when swap-pane comes along.
24544e179ddaSchristos
24554e179ddaSchristos31 March 2009
24564e179ddaSchristos
24574e179ddaSchristos* AIX port, thanks to cmihai for access to a box. Only tested on 6.1 with xlc
24584e179ddaSchristos  10.1 (make sure CC is set). Needs GNU make and probably ncurses (didn't try
24594e179ddaSchristos  plain curses). Also won't build with DEBUG, so comment the FDEBUG=1 line in
24604e179ddaSchristos  GNUmakefile.
24614e179ddaSchristos* Draw a vertical line on the right when the window size is less than the
24624e179ddaSchristos  terminal size. This is partly to shake out any horizontal limit bugs on the
24634e179ddaSchristos  way to horizontal splitting/pane tiling. Currently a bit slow since it has to
24644e179ddaSchristos  do a lot of redrawing but hopefully that will improve as I get some better
24654e179ddaSchristos  ideas for how to do it.
24664e179ddaSchristos* Fix remaining problems with copy and paste and UTF-8.
24674e179ddaSchristos
24684e179ddaSchristos28 March 2009
24694e179ddaSchristos
24704e179ddaSchristos* Better UTF-8 support, including combined characters. Unicode data is now
24714e179ddaSchristos  stored as UTF-8 in a separate array, the code does a lookup into this every
24724e179ddaSchristos  time it gets to a UTF-8 cell. Zero width characters are just appended onto
24734e179ddaSchristos  the UTF-8 data for the previous cell. This also means that almost no bytes
24744e179ddaSchristos  extra are wasted non-Unicode data (yay).
24754e179ddaSchristos
24764e179ddaSchristos  Still some oddities, such as copy mode skips over wide characters in a
24774e179ddaSchristos  strange way, and the code could do with some tidying.
24784e179ddaSchristos* Key repeating is now a property of the key binding not of the command.
24794e179ddaSchristos  Repeat is turned on when the key is bound with the -r flag to bind-key.
24804e179ddaSchristos  next/previous-window no longer repeat by default as it turned out to annoy
24814e179ddaSchristos  me.
24824e179ddaSchristos
24834e179ddaSchristos27 March 2009
24844e179ddaSchristos
24854e179ddaSchristos* Clear using ED when redrawing the screen. I foolishly assumed using spaces
24864e179ddaSchristos  would be equivalent and terminals would pick up on this, but apparently not.
24874e179ddaSchristos  This fixes copy and paste in xterm/rxvt.
24884e179ddaSchristos* Sockets in /tmp are now created in a subdirectory named, tmux-UID, eg
24894e179ddaSchristos  tmux-1000. The default socket is thus /tmp/tmux-UID/default. To start a
24904e179ddaSchristos  separate server, the new -L command line option should be used: this creates
24914e179ddaSchristos  a socket in the same directory with a different name ("-L main" will create
24924e179ddaSchristos  socket called "main"). -S should only be used to place the socket outside
24934e179ddaSchristos  /tmp. This makes sockets a little more secure and a bit more convenient to
24944e179ddaSchristos  use multiple servers.
24954e179ddaSchristos
24964e179ddaSchristos21 March 2009
24974e179ddaSchristos
24984e179ddaSchristos* New session flag "set-remain-on-exit" to set remain-on-exit flag for new
24994e179ddaSchristos  windows created in that session (like "remain-by-default" used to do). Not
25004e179ddaSchristos  perfectly happy about this, but until I can think of a good way to introduce
25014e179ddaSchristos  it generically (maybe a set of options in the session) this will do. Fixes
25024e179ddaSchristos  SF request 2527847.
25034e179ddaSchristos
25044e179ddaSchristos07 March 2009
25054e179ddaSchristos
25064e179ddaSchristos* Support for 88 colour terminals.
25074e179ddaSchristos* break-pane command to create a new window using an existing pane.
25084e179ddaSchristos
25094e179ddaSchristos02 March 2009
25104e179ddaSchristos
25114e179ddaSchristos* Make escape key timer work properly so escape+key can be used without
25124e179ddaSchristos  lightning fast key presses.
25134e179ddaSchristos
25144e179ddaSchristos13 February 2009
25154e179ddaSchristos
25164e179ddaSchristos* Redo mode keys slightly more cleanly and apply them to command prompt
25174e179ddaSchristos  editing. vi or emacs mode is controlled by the session option status-keys.
25184e179ddaSchristos
25194e179ddaSchristos12 February 2009
25204e179ddaSchristos
25214e179ddaSchristos* Looking up argv[0] is expensive, so just use p_comm for the window name which
25224e179ddaSchristos  is good enough. Also increase name update time to 500 ms.
25234e179ddaSchristos
25244e179ddaSchristos11 February 2009
25254e179ddaSchristos
25264e179ddaSchristos* Only use ri when actually at the top of the screen; just move the cursor up
25274e179ddaSchristos  otherwise.
25284e179ddaSchristos* FreeBSD's console wraps lines at $COLUMNS - 1 rather than $COLUMNS (the
25294e179ddaSchristos  cursor can never be beyond $COLUMNS - 1) and does not appear to support
25304e179ddaSchristos  changing this behaviour, or any of the obvious possibilities (turning off
25314e179ddaSchristos  right margin wrapping, insert mode). This is irritating, most notably because
25324e179ddaSchristos  it impossible to write to the very bottom-right of the screen without
25334e179ddaSchristos  scrolling. To work around this, if built on FreeBSD and run with a "cons"
25344e179ddaSchristos  $TERM, the bottom-right cell on the screen is omitted.
25354e179ddaSchristos* Emulate scroll regions (slowly) to support the few terminals which don't have
25364e179ddaSchristos  it (some of which don't really have any excuse).
25374e179ddaSchristos
25384e179ddaSchristos10 February 2009
25394e179ddaSchristos
25404e179ddaSchristos* No longer redraw the status line every status-interval unless it has actually
25414e179ddaSchristos  changed.
25424e179ddaSchristos
25434e179ddaSchristos08 February 2009
25444e179ddaSchristos
25454e179ddaSchristos* Don't treat empty arguments ("") differently when parsing configuration
25464e179ddaSchristos  file/command prompt rather than command line.
25474e179ddaSchristos* tmux 0.7 released.
25484e179ddaSchristos
25494e179ddaSchristos03 February 2009
25504e179ddaSchristos
25514e179ddaSchristos* New command, copy-buffer (alias copyb), to copy a session paste buffer to
25524e179ddaSchristos  another session.
25534e179ddaSchristos
25544e179ddaSchristos01 February 2009
25554e179ddaSchristos
25564e179ddaSchristos* The character pair #(command) may now contain (escaped) right parenthesis.
25574e179ddaSchristos
25584e179ddaSchristos30 January 2009
25594e179ddaSchristos
25604e179ddaSchristos* . now bound to "command-prompt 'move-window %%'" by default, from joshe.
25614e179ddaSchristos
25624e179ddaSchristos29 January 2009
25634e179ddaSchristos
25644e179ddaSchristos* Window options to set status line fg, bg and attributes for a single
25654e179ddaSchristos  window. Options are: window-status-fg, window-status-bg,
25664e179ddaSchristos  window-status-attr. Set to "default" to use the session status colours.
25674e179ddaSchristos
25684e179ddaSchristos  This allows quite neat things like:
25694e179ddaSchristos
25704e179ddaSchristos	$ cat ~/bin/xssh
25714e179ddaSchristos	#!/bin/sh
25724e179ddaSchristos
25734e179ddaSchristos	if [ ! -z "$TMUX" ]; then
25744e179ddaSchristos	case "$1" in
25754e179ddaSchristos    	natalya)
25764e179ddaSchristos	        tmux setw window-status-fg red >/dev/null
25774e179ddaSchristos		;;
25784e179ddaSchristos	natasha)
25794e179ddaSchristos        	tmux setw window-status-fg yellow >/dev/null
25804e179ddaSchristos		;;
25814e179ddaSchristos	esac
25824e179ddaSchristos	fi
25834e179ddaSchristos	ssh "$@"
25844e179ddaSchristos	[ ! -z "$TMUX" ] && tmux setw -u window-status-fg >/dev/null
25854e179ddaSchristos	$ alias ssh="~/bin/xssh"
25864e179ddaSchristos
25874e179ddaSchristos* Support #(command) in status-left, and status-right, which is displayed as
25884e179ddaSchristos  the first line of command's output (e.g. set -g status-right
25894e179ddaSchristos  "#(whoami)@#(hostname -s)"). Commands with )s aren't supported.
25904e179ddaSchristos
25914e179ddaSchristos28 January 2009
25924e179ddaSchristos
25934e179ddaSchristos* Support mouse in copy mode to move cursor. Can't do anything else at the
25944e179ddaSchristos  moment until other mouse modes are handled.
25954e179ddaSchristos* Better support for at least the most common variant of mouse input: parse it
25964e179ddaSchristos  and adjust for different panes. Also support mouse in window/session choice
25974e179ddaSchristos  mode.
25984e179ddaSchristos
25994e179ddaSchristos27 January 2009
26004e179ddaSchristos
26014e179ddaSchristos* Bring back the fancy window titles with session/window names: it is easy to
26024e179ddaSchristos  work around problems with elinks (see FAQ).
26034e179ddaSchristos* -u flag to scroll-mode and copy-mode to start scrolled one page
26044e179ddaSchristos  up. scroll-mode -u is bound to prefix,page-up (ppage) by default.
26054e179ddaSchristos* Allow status, mode and message attributes to be changed by three new options:
26064e179ddaSchristos  status-attr, mode-attr, message-attr. A comma-separated list is accepted
26074e179ddaSchristos  containing: bright, dim, underscore, blink, reverse, hidden, italics, for
26084e179ddaSchristos  example:
26094e179ddaSchristos
26104e179ddaSchristos	set -g status-attr bright,blink
26114e179ddaSchristos
26124e179ddaSchristos  From Josh Elsasser, thanks!
26134e179ddaSchristos
26144e179ddaSchristos26 January 2009
26154e179ddaSchristos
26164e179ddaSchristos* Be more clever about picking the right process to create the window name.
26174e179ddaSchristos* Don't balls up the terminal on UTF-8 combined characters. Don't support them
26184e179ddaSchristos  properly either - they are just discarded for the moment.
26194e179ddaSchristos
26204e179ddaSchristos25 January 2009
26214e179ddaSchristos
26224e179ddaSchristos* load-buffer command
26234e179ddaSchristos
26244e179ddaSchristos23 January 2009
26254e179ddaSchristos
26264e179ddaSchristos* Use reverse colours rather than swapping fg and bg for message, mode and
26274e179ddaSchristos  status line. This makes these usable on black and white terminals.
26284e179ddaSchristos* Better error messages when creating a session or window fails.
26294e179ddaSchristos* Oops. Return non-zero on error. Reported by Will Maier.
26304e179ddaSchristos
26314e179ddaSchristos21 January 2009
26324e179ddaSchristos
26334e179ddaSchristos* Handle SIGTERM (and kill-server which uses it), a bit more neatly - tidy
26344e179ddaSchristos  up properly and print a nicer message. Same effect though :-).
26354e179ddaSchristos* new-window now supports -k to kill target window if it exists.
26364e179ddaSchristos* Bring back split-window -p and -l options to specify the height a percentage
26374e179ddaSchristos  or as a number of lines.
26384e179ddaSchristos* Make window and session choice modes allow you to choose items in vi keys
26394e179ddaSchristos  mode (doh!). As a side-effect, this makes enter copy selection (as well
26404e179ddaSchristos  as C-w/M-w) when using emacs keys in copy mode. Reported by merdely.
26414e179ddaSchristos
26424e179ddaSchristos20 January 2009
26434e179ddaSchristos
26444e179ddaSchristos* Darwin support for automatic-rename from joshe; Darwin doesn't seem to have
26454e179ddaSchristos  a sane method of getting argv[0] and searching for the precise insane way
26464e179ddaSchristos  is too frustrating, so this just uses the executable name.
26474e179ddaSchristos* Try to change the window title to match the command running it in. This is
26484e179ddaSchristos  done by reading argv[0] from the process group leader of the group that owns
26494e179ddaSchristos  the tty (tcgetpgrp()). This can't be done portably so some OS-dependent code
26504e179ddaSchristos  is introduced (ugh); OpenBSD, FreeBSD and Linux are supported at the moment.
26514e179ddaSchristos
26524e179ddaSchristos  A new window flag, automatic-rename, is available: if this is set to off, the
26534e179ddaSchristos  window name is not changed. Specifying a name with the new-window,
26544e179ddaSchristos  new-session or rename-window commands will automatically set this flag to off
26554e179ddaSchristos  for the window in question. To disable it entirely set the option to off
26564e179ddaSchristos  globally (setw -g automatic-rename off).
26574e179ddaSchristos
26584e179ddaSchristos19 January 2009
26594e179ddaSchristos
26604e179ddaSchristos* Fix various stupid issues when the status line is turned off. Grr.
26614e179ddaSchristos* Use reverse attributes for clock and cursor, otherwise they do not
26624e179ddaSchristos  appear on black and white terminals.
26634e179ddaSchristos* An error in a command sequence now stops execution of that sequence.
26644e179ddaSchristos  Internally, each command code now passes a return code back rather than
26654e179ddaSchristos  talking to the calling client (if any) directly.
26664e179ddaSchristos* attach-session now tries to start the server if it isn't already started - if
26674e179ddaSchristos  no sessions are created in .tmux.conf this will cause an error.
26684e179ddaSchristos* Clean up starting server by making initial client get a special socketpair.
26694e179ddaSchristos
26704e179ddaSchristos18 January 2009
26714e179ddaSchristos
26724e179ddaSchristos* Unbreak UTF-8.
26734e179ddaSchristos* -a flag to next-window and previous-window to select the next or previous
26744e179ddaSchristos  window with activity or bell. Bound to M-n and M-p.
26754e179ddaSchristos* find-window command to search window names, titles and visible content (but
26764e179ddaSchristos  not history) for a string. If only one is found, the window is selected
26774e179ddaSchristos  otherwise a choice list is shown. This (as with the other choice commands)
26784e179ddaSchristos  only works from a key. Bound to "f" by default.
26794e179ddaSchristos* Cleaned up command printing code, also enclose arguments with spaces in "s.
26804e179ddaSchristos* Added command sequences. These are entered by separating each argument by a ;
26814e179ddaSchristos  argument (spaces on both sides), for example:
26824e179ddaSchristos
26834e179ddaSchristos	lsk ; lsc
26844e179ddaSchristos
26854e179ddaSchristos  To use a literal ; as the argument prefix it with \, for example:
26864e179ddaSchristos
26874e179ddaSchristos	bind x lsk \; lsc
26884e179ddaSchristos
26894e179ddaSchristos  Commands are executed from left to right. Also note that command sequences do
26904e179ddaSchristos  not support repeat-time repetition unless all commands making up the sequence
26914e179ddaSchristos  support it.
26924e179ddaSchristos* suspend-client command to suspend a client. Don't try to background it
26934e179ddaSchristos  though...
26944e179ddaSchristos* Mark attached sessions in sessions lists. Suggested by Simon Kuhnle.
26954e179ddaSchristos
26964e179ddaSchristos17 January 2009
26974e179ddaSchristos
26984e179ddaSchristos* tmux 0.6 released.
26994e179ddaSchristos
27004e179ddaSchristos15 January 2009
27014e179ddaSchristos
27024e179ddaSchristos* Support #H for hostname and #S for session name in status-left/right.
27034e179ddaSchristos* Two new commands, choose-window and choose-session which work only when bound
27044e179ddaSchristos  to a key and allow the window or session to be selected from a list. These
27054e179ddaSchristos  are now bound to "w" and "s" instead of the list commands.
27064e179ddaSchristos
27074e179ddaSchristos14 January 2009
27084e179ddaSchristos
27094e179ddaSchristos* Rework the prefix-time stuff. The option is now called repeat-time and
27104e179ddaSchristos  defaults to 500 ms. It only applies to a small subset of commands, currently:
27114e179ddaSchristos  up-pane, down-pane, next-window, previous-window, resize-pane-up,
27124e179ddaSchristos  resize-pane-down. These are the commands for which it is obviously useful,
27134e179ddaSchristos  having it for everything else was just bloody annoying.
27144e179ddaSchristos* The alt-up and alt-down keys now resize a pane by five lines at a time.
27154e179ddaSchristos* switch-pane is now select-pane and requires -p to select a pane. The
27164e179ddaSchristos  "o" key binding is changed to down-pane.
27174e179ddaSchristos* up-pane and down-pane commands, bound to arrow up and down by default.
27184e179ddaSchristos* Multiple vertical window splitting. Minimum pane size is four lines, an
27194e179ddaSchristos  (unhelpful) error will be shown if attempting to split a window with less
27204e179ddaSchristos  that eight lines. If the window is resized, as many panes are shown as can
27214e179ddaSchristos  fit without reducing them below four lines. There is (currently!) not a way
27224e179ddaSchristos  to show a hidden pane without making the window larger.
27234e179ddaSchristos
27244e179ddaSchristos  Note the -p and -l options to split-window are now gone, these may reappear
27254e179ddaSchristos  once I think them through again.
27264e179ddaSchristos* Server locking on inactivity (lock-after-time) is now disabled by default.
27274e179ddaSchristos
27284e179ddaSchristos13 January 2009
27294e179ddaSchristos
27304e179ddaSchristos* kill-pane command.
27314e179ddaSchristos
27324e179ddaSchristos12 January 2009
27334e179ddaSchristos
27344e179ddaSchristos* command-prompt now accepts a single argument, a template string. Any
27354e179ddaSchristos  occurrences of %% in this string are replaced by whatever is entered at the
27364e179ddaSchristos  prompt and the result is executed as a command. This allows things like (now
27374e179ddaSchristos  bound by default):
27384e179ddaSchristos
27394e179ddaSchristos  	 bind , command-prompt "rename-window %%"
27404e179ddaSchristos
27414e179ddaSchristos  Or my favourite:
27424e179ddaSchristos
27434e179ddaSchristos         bind x command-prompt "split-window 'man %%'"
27444e179ddaSchristos
27454e179ddaSchristos* Option to set prefix time, allowing multiple commands to be entered without
27464e179ddaSchristos  pressing the prefix key again, so long as they each typed within this time of
27474e179ddaSchristos  each other.
27484e179ddaSchristos* Yet more hacks for key handling. Think it is just about working now.
27494e179ddaSchristos* Two commands, resize-pane-up and resize-pane-down to resize a pane.
27504e179ddaSchristos* Make the window pane code handle panes of different sizes, and add a -l
27514e179ddaSchristos  and -p arguments to split-window to specify the new window size in lines
27524e179ddaSchristos  or as a percentage.
27534e179ddaSchristos
27544e179ddaSchristos11 January 2009
27554e179ddaSchristos
27564e179ddaSchristos* Vertical window splitting. Currently can only split a window into two panes.
27574e179ddaSchristos  New split-window command splits (bound to ") and switch-pane command (bound to
27584e179ddaSchristos  o) switches between panes.
27594e179ddaSchristos
27604e179ddaSchristos  close-pane, swap-pane commands are to follow. Also to come are pane resizing,
27614e179ddaSchristos  >2 panes, the ability to break a pane out to a full window and vice versa and
27624e179ddaSchristos  possibly horizontal splitting.
27634e179ddaSchristos
27644e179ddaSchristos  Panes are subelements of windows rather than being windows in their own
27654e179ddaSchristos  right. I tried to make them windows (so the splitting was at the session or
27664e179ddaSchristos  client level) but this rapidly became very complex and invasive. So in the
27674e179ddaSchristos  interests of having something working, I just made it so each window can have
27684e179ddaSchristos  two child processes instead of one (and it still took me 12 hours straight
27694e179ddaSchristos  coding). Now the concept is proven and much of the support code is there,
27704e179ddaSchristos  this may change in future if more flexibility is needed.
27714e179ddaSchristos* save-buffer command, from Tiago Cunha.
27724e179ddaSchristos
27734e179ddaSchristos10 January 2009
27744e179ddaSchristos
27754e179ddaSchristos* New option, lock-after-time. If there is no activity in the period specified
27764e179ddaSchristos  by this option (in seconds), tmux will lock the server. Default is 1800 (30
27774e179ddaSchristos  minutes), set to 0 to disable.
27784e179ddaSchristos* Server locking. Two new commands: set-password to set a password (a
27794e179ddaSchristos  preencrypted password may be specified with -c); and lock-server to lock the
27804e179ddaSchristos  server until the password is entered. Also an additional command line flag,
27814e179ddaSchristos  -U, to unlock from the shell. The default password is blank (any password
27824e179ddaSchristos  accepted). If specifying an encrypted password from encrypt(1) in .tmux.conf
27834e179ddaSchristos  with -c, don't forget to enclose it in single-quotes (') to prevent shell
27844e179ddaSchristos  variable expansion.
27854e179ddaSchristos* If a window is created from the command line, tmux will now use the same
27864e179ddaSchristos  current working directory for the new process. A new default-path option to
27874e179ddaSchristos  sets the working directory for processes created from keys or interactively
27884e179ddaSchristos  from the prompt.
27894e179ddaSchristos* New mode to display a large clock. Entered with clock-mode command (bound to
27904e179ddaSchristos  C-b t by default); two window options: clock-mode-colour and clock-mode-style
27914e179ddaSchristos  (12 or 24). This will probably be used as the basis for window locking.
27924e179ddaSchristos* New command, server-info, to show some server information and terminal
27934e179ddaSchristos  details.
27944e179ddaSchristos
27954e179ddaSchristos09 January 2009
27964e179ddaSchristos
27974e179ddaSchristos* Stop using ncurses variables and instead build a table of the codes we want
27984e179ddaSchristos  into an array for each terminal type. This makes the code a little more
27994e179ddaSchristos  untidy in places but gets rid of the awful global variables and calling
28004e179ddaSchristos  setterm all the time, and shoves all the ncurses-dependent mess into a single
28014e179ddaSchristos  file, tty-term.c. It also allows overriding single terminal codes, this is
28024e179ddaSchristos  used to fix rxvt on some platforms (where it is missing dch) and in future
28034e179ddaSchristos  may allow user customisation a la vim.
28044e179ddaSchristos* Update key handling code. Simplify, support ctrl properly and add a new
28054e179ddaSchristos  window option (xterm-keys) to output xterm key codes including ctrl and,
28064e179ddaSchristos  if available, alt and shift.
28074e179ddaSchristos
28084e179ddaSchristos08 January 2009
28094e179ddaSchristos
28104e179ddaSchristos* If built without DEBUG (the release versions), don't cause a fatal error if
28114e179ddaSchristos  the grid functions notice an input error, just log and ignore the
28124e179ddaSchristos  request. This might mean me getting shouted at less often when bugs kill
28134e179ddaSchristos  long-running sessions, at least in release versions.
28144e179ddaSchristos* Hopefully fix cursor out-of-bounds checking when writing to grid. When I
28154e179ddaSchristos  wrote the code I must have forgotten that the cursor can be one cell off the
28164e179ddaSchristos  right of the screen (yes, I know), so there were number of out-of-bounds/
28174e179ddaSchristos  overflow problems.
28184e179ddaSchristos
28194e179ddaSchristos07 January 2009
28204e179ddaSchristos
28214e179ddaSchristos* New flag to set and setw, -u, to unset an option (allowing it to inherit from)
28224e179ddaSchristos  the global options again.
28234e179ddaSchristos* Added more info messages for options changes.
28244e179ddaSchristos* A bit of tidying and reorganisation of options code.
28254e179ddaSchristos
28264e179ddaSchristos06 January 2009
28274e179ddaSchristos
28284e179ddaSchristos* Don't crash when backspacing if cursor is off the right of the screen,
28294e179ddaSchristos  reported by David Chisnall.
28304e179ddaSchristos* Complete words at any point inside command in prompt, also use option name
28314e179ddaSchristos  as well as command names.
28324e179ddaSchristos* Per-client prompt history of up to 100 items.
28334e179ddaSchristos* Use a splay tree for key bindings instead of an array. As a side-effect this
28344e179ddaSchristos  sorts them when listed.
28354e179ddaSchristos
28364e179ddaSchristos22 December 2008
28374e179ddaSchristos
28384e179ddaSchristos* Use the right keys for home and end.
28394e179ddaSchristos
28404e179ddaSchristos20 December 2008
28414e179ddaSchristos
28424e179ddaSchristos* Add vim mode for tmux configuration file to examples/, from Tiago Cunha.
28434e179ddaSchristos
28444e179ddaSchristos15 December 2008
28454e179ddaSchristos
28464e179ddaSchristos* New command, source-file (alias source), to load a configuration
28474e179ddaSchristos  file. Written by Tiago Cunha, many thanks.
28484e179ddaSchristos
28494e179ddaSchristos13 December 2008
28504e179ddaSchristos
28514e179ddaSchristos* Work around lack of dch. On Linux, the rxvt termcap doesn't have it (it is
28524e179ddaSchristos  lying, but we can't really start disbelieving termcaps...). This is a bit
28534e179ddaSchristos  horrible - I can see no way to do it without pretty much redrawing the whole
28544e179ddaSchristos  line, but it works...
28554e179ddaSchristos
28564e179ddaSchristos10 December 2008
28574e179ddaSchristos
28584e179ddaSchristos* glibc's getopt(3) is useless: it is not POSIX compliant without jumping
28594e179ddaSchristos  through non-portable hoops, and the method of resetting it is unclear (the
28604e179ddaSchristos  man page on my system says set optind to 1, but other sources say 0). So,
28614e179ddaSchristos  import OpenBSD's getopt_long.c into compat/ for use on Linux and use the
28624e179ddaSchristos  clearly documented optreset = optind = 1 method. This fixes some strange
28634e179ddaSchristos  issues with command parsing (getting the syntax wrong would prevent any
28644e179ddaSchristos  further commands being parsed).
28654e179ddaSchristos
28664e179ddaSchristos06 December 2008
28674e179ddaSchristos
28684e179ddaSchristos* Bring set/setw/show/showw into line with other commands. This means that by
28694e179ddaSchristos  default they now affect the current window (if any); the new -g flag must be
28704e179ddaSchristos  passed to set the global options. This changes the behaviour of set/show and
28714e179ddaSchristos  WILL BREAK CURRENT CONFIGURATIONS.
28724e179ddaSchristos
28734e179ddaSchristos  In summary, whether in the configuration file, the command prompt, or a key
28744e179ddaSchristos  binding, use -g to set a global option, use -t to specify a particular window
28754e179ddaSchristos  or session, or omit both to try and use the current window or session.
28764e179ddaSchristos
28774e179ddaSchristos  This makes set/show a bit of a pain but is the correct behaviour for
28784e179ddaSchristos  setw/showw and is the same as every other command, so we can put up with a
28794e179ddaSchristos  bit of pain for consistency.
28804e179ddaSchristos* Redo window options. They now work in the same way to session options with a
28814e179ddaSchristos  global options set. showw/setw commands now have similar syntax to show/set
28824e179ddaSchristos  (including the ability to use abbreviations).
28834e179ddaSchristos
28844e179ddaSchristos  PLEASE NOTE this includes the following configuration-breaking changes:
28854e179ddaSchristos
28864e179ddaSchristos  - remain-by-default is now GONE, use "setw -g remain-on-exit" to apply the
28874e179ddaSchristos    global window option instead;
28884e179ddaSchristos  - mode-keys is now a window option rather than session - use "setw [-g]
28894e179ddaSchristos    mode-keys" instead of set.
28904e179ddaSchristos
28914e179ddaSchristos  There are also some additions:
28924e179ddaSchristos
28934e179ddaSchristos  - message-fg and message-bg session options to control status line message
28944e179ddaSchristos    colours;
28954e179ddaSchristos  - mode-fg and mode-bg window options to set colours in window modes such as
28964e179ddaSchristos    copy mode.
28974e179ddaSchristos
28984e179ddaSchristos  The options code still a mess and now there is twice as much of it :-(.
28994e179ddaSchristos
29004e179ddaSchristos02 December 2008
29014e179ddaSchristos
29024e179ddaSchristos* Add support for including the window title in status-left or status-right
29034e179ddaSchristos  strings by including the character pair "#T". This may be prefixed with
29044e179ddaSchristos  a number to specify a maximum length, for example "#24T" to use at most
29054e179ddaSchristos  24 characters of the title.
29064e179ddaSchristos* Introduce two new options, status-left-length and status-right-length,
29074e179ddaSchristos  control the maximum length of left and right components of the status bar.
29084e179ddaSchristos* elinks (and possibly others) bypass the terminal and talk directly to X to
29094e179ddaSchristos  restore the window title when exiting. tmux can't know about this particular
29104e179ddaSchristos  bit of stupidity so the title ends up strange - the prefix isn't terribly
29114e179ddaSchristos  important and elinks is quite useful so just get rid of it.
29124e179ddaSchristos
29134e179ddaSchristos27 November 2008
29144e179ddaSchristos
29154e179ddaSchristos* Tweaks to support Dragonfly.
29164e179ddaSchristos
29174e179ddaSchristos17 November 2008
29184e179ddaSchristos
29194e179ddaSchristos* tmux 0.5 released.
29204e179ddaSchristos
29214e179ddaSchristos16 November 2008
29224e179ddaSchristos
29234e179ddaSchristos* New window option: "utf8"; this must be on (it is off by default) for UTF-8
29244e179ddaSchristos  to be parsed. The global/session option "utf8-default" controls the setting
29254e179ddaSchristos  for new windows.
29264e179ddaSchristos
29274e179ddaSchristos  This means that by default tmux does not handle UTF-8. To use UTF-8 by
29284e179ddaSchristos  default it is necessary to a) "set utf8-default on" in .tmux.conf b) start
29294e179ddaSchristos  tmux with -u on any terminal which support UTF-8.
29304e179ddaSchristos
29314e179ddaSchristos  It seems a bit unnecessary for this to be a per-window option but that is
29324e179ddaSchristos  the easiest way to do it, and it can't do any harm...
29334e179ddaSchristos* Enable default colours if op contains \033[39;49m, based on a report from
29344e179ddaSchristos  fulvio ciriaco.
29354e179ddaSchristos
29364e179ddaSchristos12 November 2008
29374e179ddaSchristos
29384e179ddaSchristos* Keep stack of last windows rather than just most recent; based on a diff from
29394e179ddaSchristos  joshe.
29404e179ddaSchristos
29414e179ddaSchristos04 November 2008
29424e179ddaSchristos
29434e179ddaSchristos* Don't try to redraw status line when showing a prompt or message; if it does,
29444e179ddaSchristos  the status timer is never reset so it redraws on every loop. Spotted by
29454e179ddaSchristos  joshe.
29464e179ddaSchristos
29474e179ddaSchristos09 October 2008
29484e179ddaSchristos
29494e179ddaSchristos* Translate 256 colours into 16 if 256 is not available, same as screen does.
29504e179ddaSchristos* Better support for OSC command (only to set window title now), and also
29514e179ddaSchristos  support using APC for the same purpose (some Linux default shell profiles do
29524e179ddaSchristos  this).
29534e179ddaSchristos
29544e179ddaSchristos25 September 2008
29554e179ddaSchristos
29564e179ddaSchristos* Large internal rewrite to better support 256 colours and UTF-8. Screen data
29574e179ddaSchristos  is now stored as single two-way array of structures rather than as multiple
29584e179ddaSchristos  separate arrays. Also simplified a lot of code.
29594e179ddaSchristos
29604e179ddaSchristos  Only external changes are three new flags, -2, -d and -u, which force tmux to
29614e179ddaSchristos  assume the terminal supports 256 colours, default colours (useful for
29624e179ddaSchristos  xterm-256color which lacks the AX flag), or UTF-8 respectively.
29634e179ddaSchristos
29644e179ddaSchristos10 September 2008
29654e179ddaSchristos
29664e179ddaSchristos* Split off colour conversion code from screen code.
29674e179ddaSchristos
29684e179ddaSchristos09 September 2008
29694e179ddaSchristos
29704e179ddaSchristos* Initial UTF-8 support. A bit ugly and with a limit of 4096 UTF-8
29714e179ddaSchristos  characters per window.
29724e179ddaSchristos
29734e179ddaSchristos08 September 2008
29744e179ddaSchristos
29754e179ddaSchristos* 256 colour support. tmux attempts to autodetect the terminal by looking
29764e179ddaSchristos  both at what ncurses reports (usually wrong for xterm) and checking if
29774e179ddaSchristos  the TERM contains "256col". For xterm TERM=xterm-256color is needed (as
29784e179ddaSchristos  well as a build that support 256 colours); this seems to work for rxvt
29794e179ddaSchristos  as well. On non-256 colour terminals, high colours are translated to white
29804e179ddaSchristos  foreground and black background.
29814e179ddaSchristos
29824e179ddaSchristos28 August 2008
29834e179ddaSchristos
29844e179ddaSchristos* Support OS X/Darwin thanks to bsd-poll.c from OpenSSH. Also convert
29854e179ddaSchristos  from clock_gettime(2) to gettimeofday(2) as OS X doesn't support the
29864e179ddaSchristos  former; microsecond accuracy will have to be sufficient ;-).
29874e179ddaSchristos
29884e179ddaSchristos07 August 2008
29894e179ddaSchristos
29904e179ddaSchristos* Lose some unused/useless wrapper functions.
29914e179ddaSchristos
29924e179ddaSchristos25 July 2008
29934e179ddaSchristos
29944e179ddaSchristos* Shell variables may now be defined and used in configuration file. Define
29954e179ddaSchristos  variables with:
29964e179ddaSchristos
29974e179ddaSchristos	VAR=1
29984e179ddaSchristos
29994e179ddaSchristos  And use with:
30004e179ddaSchristos
30014e179ddaSchristos        renamew ${VAR}
30024e179ddaSchristos	renamew "x${VAR}x"
30034e179ddaSchristos
30044e179ddaSchristos Also some other fixes to make, for example, "abc""abc" work similarly to
30054e179ddaSchristos the shell.
30064e179ddaSchristos
30074e179ddaSchristos24 July 2008
30084e179ddaSchristos
30094e179ddaSchristos* Finally lose inconsistently-used SCREEN_DEF* defines.
30104e179ddaSchristos* If cursor mode is on, switch the arrow keys from \033[A to \033OA.
30114e179ddaSchristos* Support the numeric keypad in both application and numbers mode. This is
30124e179ddaSchristos  different from screen which always keeps it in application mode.
30134e179ddaSchristos
30144e179ddaSchristos19 July 2008
30154e179ddaSchristos
30164e179ddaSchristos* Unbreak "set status" - tmux thought it was ambiguous, reported by rivo nurges.
30174e179ddaSchristos
30184e179ddaSchristos02 July 2008
30194e179ddaSchristos
30204e179ddaSchristos* Split vi and emacs mode keys into two tables and add an option (mode-keys)
30214e179ddaSchristos  to select between them. Default is emacs, use,
30224e179ddaSchristos
30234e179ddaSchristos     tmux set mode-keys vi
30244e179ddaSchristos
30254e179ddaSchristos  to change to vi.
30264e179ddaSchristos
30274e179ddaSchristos  vi mode uses space to start selection, enter to copy selection and escape
30284e179ddaSchristos  to clear selection.
30294e179ddaSchristos
30304e179ddaSchristos01 July 2008
30314e179ddaSchristos
30324e179ddaSchristos* Protocol versioning. Clients which identify as a different version from the
30334e179ddaSchristos  server will be rejected.
30344e179ddaSchristos* tmux 0.4 released.
30354e179ddaSchristos
30364e179ddaSchristos29 June 2008
30374e179ddaSchristos
30384e179ddaSchristos* Zombie windows. These are not closed when the child process dies. May be
30394e179ddaSchristos  set for a window with the new "remain-on-exit" option; the default setting
30404e179ddaSchristos  of this flag for new windows may be set with the "remain-by-default" session
30414e179ddaSchristos  option.
30424e179ddaSchristos
30434e179ddaSchristos  A window may be restarted with the respawn-window command:
30444e179ddaSchristos
30454e179ddaSchristos  	respawn-window [-k] [command]
30464e179ddaSchristos
30474e179ddaSchristos  If -k is given, any existing process running in the window is killed;
30484e179ddaSchristos  if command is omitted, the same command as when the window was first
30494e179ddaSchristos  created is used.
30504e179ddaSchristos
30514e179ddaSchristos27 June 2008
30524e179ddaSchristos
30534e179ddaSchristos* Handle nonexistent session or client to -t properly.
30544e179ddaSchristos
30554e179ddaSchristos25 June 2008
30564e179ddaSchristos
30574e179ddaSchristos* select-prompt command to allow a window to be selected at a prompt. Only
30584e179ddaSchristos  windows in the current session may be selected. Bound to ' by default.
30594e179ddaSchristos  Suggested by merdely.
30604e179ddaSchristos* move-window command. Requested by merdely.
30614e179ddaSchristos* Support binding alt keys (prefixed with M-). Change default to use
30624e179ddaSchristos  C- for ctrl keys (^ is still accepted as an alternative).
30634e179ddaSchristos* Slim down default key bindings: support lowercase only.
30644e179ddaSchristos* Handle escaped keys properly (parse eg \033b into a single key code) and
30654e179ddaSchristos  use this to change copy mode next/previous work to M-f and M-b to match
30664e179ddaSchristos  emacs.
30674e179ddaSchristos
30684e179ddaSchristos24 June 2008
30694e179ddaSchristos
30704e179ddaSchristos* Next word (C-n/w) and previous word (C-b/b) in copy mode.
30714e179ddaSchristos
30724e179ddaSchristos23 June 2008
30734e179ddaSchristos
30744e179ddaSchristos* list-commands command (alias lscm).
30754e179ddaSchristos* Split information about options into a table and use it to parse options
30764e179ddaSchristos  on input (allowing abbreviations) and to print them with show-options
30774e179ddaSchristos  (meaning that bell-action gets a proper string). This turned out a bit ugly
30784e179ddaSchristos  though :-/.
30794e179ddaSchristos
30804e179ddaSchristos22 June 2008
30814e179ddaSchristos
30824e179ddaSchristos* Do not translate black and white into default if the terminal supports
30834e179ddaSchristos  default colours. This was nice to force programs which didn't use default
30844e179ddaSchristos  colours to be properly transparent in rxvt/aterm windows with a background
30854e179ddaSchristos  image, but it causes trouble if someone redefines the default foreground and
30864e179ddaSchristos  background (to have black on white or something).
30874e179ddaSchristos
30884e179ddaSchristos21 June 2008
30894e179ddaSchristos
30904e179ddaSchristos* Naive tab completion in the command prompt. This only completes command
30914e179ddaSchristos  names if a) they are at the start of the text b) the cursor is at
30924e179ddaSchristos  the end of the text c) the text contains no spaces.
30934e179ddaSchristos* Only attempt to set the title where TERM looks like an xterm (contains
30944e179ddaSchristos  "xterm", "rxvt" or is "screen"). I hate this but I don't see a better way:
30954e179ddaSchristos  setting the title actually kills some other terminals pretty much dead.
30964e179ddaSchristos* Strip padding out of terminfo(5) strings. Currently the padding is just
30974e179ddaSchristos  ignored, this may need to be altered if there are any software terminals
30984e179ddaSchristos  out there that actually need it.
30994e179ddaSchristos
31004e179ddaSchristos20 June 2008
31014e179ddaSchristos
31024e179ddaSchristos* buffer-limit option to set maximum size of buffer stack. Default is 9.
31034e179ddaSchristos* Initial buffer improvements. Each session has a stack of buffers and each
31044e179ddaSchristos  buffer command takes a -b option to manipulate items on the stack. If -b
31054e179ddaSchristos  is omitted, the top entry is used. The following commands are currently
31064e179ddaSchristos  available:
31074e179ddaSchristos
31084e179ddaSchristos	set-buffer [-b index] [-t target-session] string
31094e179ddaSchristos	paste-buffer [-d] [-b index] [-t target-window]
31104e179ddaSchristos	delete-buffer [-b index] [-t target-session]
31114e179ddaSchristos	show-buffers [-t target-session]
31124e179ddaSchristos	show-buffer [-b index] [-t target-session]
31134e179ddaSchristos
31144e179ddaSchristos  -d to paste-buffer deletes the buffer after pasting it.
31154e179ddaSchristos* New option, display-time, sets the time status line messages stay on screen
31164e179ddaSchristos  (unless a key is pressed). Set in milliseconds, default is 750 (0.75 seconds).
31174e179ddaSchristos  The timer is only checked every 100 ms or so.
31184e179ddaSchristos
31194e179ddaSchristos19 June 2008
31204e179ddaSchristos
31214e179ddaSchristos* Use "status" consistently for status line option, and prefix for "prefix" key
31224e179ddaSchristos  option.
31234e179ddaSchristos* Allow commands to be entered at a prompt. This is triggered with the
31244e179ddaSchristos  command-prompt command, bound to : by default.
31254e179ddaSchristos* Show status messages properly, without blocking the server.
31264e179ddaSchristos
31274e179ddaSchristos18 June 2008
31284e179ddaSchristos
31294e179ddaSchristos* New option, set-titles. On by default, this attempts to set the window title
31304e179ddaSchristos  using the \e]2;...\007 xterm code.
31314e179ddaSchristos
31324e179ddaSchristos  Note that elinks requires the STY environment variable (used by screen) to be
31334e179ddaSchristos  set before it will set the window title. So, if you want window titles set by
31344e179ddaSchristos  elinks, set STY before running it (any value will do). I can't do this for all
31354e179ddaSchristos  windows since setting it to an invalid value breaks screen.
31364e179ddaSchristos* Show arrows at either end of status line when scrolled if more windows
31374e179ddaSchristos  exist. Highlight the arrow if a hidden window has activity or bell.
31384e179ddaSchristos* Scroll the status line to show the current window if necessary. Also handle
31394e179ddaSchristos  windows smaller than needed better (show a blank status line instead of
31404e179ddaSchristos  hanging or crashing).
31414e179ddaSchristos
31424e179ddaSchristos17 June 2008
31434e179ddaSchristos
31444e179ddaSchristos* tmux 0.3 released.
31454e179ddaSchristos
31464e179ddaSchristos16 June 2008
31474e179ddaSchristos
31484e179ddaSchristos* Add some information messages when window options are changed, suggested by
31494e179ddaSchristos  Mike Erdely. Also add a -q command-line option to suppress them.
31504e179ddaSchristos* show-window-options (showw) command.
31514e179ddaSchristos
31524e179ddaSchristos15 June 2008
31534e179ddaSchristos
31544e179ddaSchristos* show-options (show) command to show one or all options.
31554e179ddaSchristos
31564e179ddaSchristos14 June 2008
31574e179ddaSchristos
31584e179ddaSchristos* New window options: force-width and force-height. This will force a window
31594e179ddaSchristos  to an arbitrary width and height (0 for the default unlimited). This is
31604e179ddaSchristos  neat for emacs which doesn't have a sensible way to force hard wrapping at 80
31614e179ddaSchristos  columns. Also, don't try to be clever and use clr_eol when redrawing the
31624e179ddaSchristos  whole screen, it causes trouble since the redraw functions are used to draw
31634e179ddaSchristos  the blank areas too.
31644e179ddaSchristos* Clear the blank area below windows properly when they are smaller than client,
31654e179ddaSchristos  also add an indicator line to show the vertical limit.
31664e179ddaSchristos* Don't die on empty strings in config file, reported by Will Maier.
31674e179ddaSchristos
31684e179ddaSchristos08 June 2008
31694e179ddaSchristos
31704e179ddaSchristos* Set socket mode +x if any sessions are attached and -x if not.
31714e179ddaSchristos
31724e179ddaSchristos07 June 2008
31734e179ddaSchristos
31744e179ddaSchristos* Make status-interval actually changeable.
31754e179ddaSchristos
31764e179ddaSchristos06 June 2008
31774e179ddaSchristos
31784e179ddaSchristos* New window option: aggressive-resize. Normally, windows are resized to the
31794e179ddaSchristos  size of the smallest attached session to which they are linked. This means a
31804e179ddaSchristos  window only changes size when sessions are detached or attached, or they are
31814e179ddaSchristos  linked or unlinked from a session. This flag changes a window to be the size
31824e179ddaSchristos  of the smallest attached session for which it is the current window - it is
31834e179ddaSchristos  resized every time a session changes to it or away from it. This is nice for
31844e179ddaSchristos  things that handle SIGWINCH well (like irssi) and bad for things like shells.
31854e179ddaSchristos* The server now exits when no sessions remain.
31864e179ddaSchristos* Fix bug with inserting characters with TERM=xterm-color.
31874e179ddaSchristos
31884e179ddaSchristos05 June 2008
31894e179ddaSchristos
31904e179ddaSchristos* Completely reorganise command parsing. Much more common code in cmd-generic.c
31914e179ddaSchristos  and a new way of specifying windows, clients or sessions. Now, most commands
31924e179ddaSchristos  take a -t argument, which specifies a client, a session, or a window target.
31934e179ddaSchristos  Clients and sessions are given alone (sessions are fnmatch(3)d and
31944e179ddaSchristos  clients currently not), windows are give by (client|session):index. For
31954e179ddaSchristos  example, if a user is in session "1" window 0 on /dev/ttypi, these should all
31964e179ddaSchristos  be equivalent:
31974e179ddaSchristos
31984e179ddaSchristos	tmux renamew newname			(current session and window)
31994e179ddaSchristos	tmux renamew -t: newname		(current session and window)
32004e179ddaSchristos	tmux renamew -t:0 newname		(current session, window 0)
32014e179ddaSchristos	tmux renamew -t0 newname		(current session, window 0)
32024e179ddaSchristos	tmux renamew -t1:0 newname		(session 1, window 0)
32034e179ddaSchristos	tmux renamew -t1: newname		(session 1's current window)
32044e179ddaSchristos	tmux renamew -t/dev/ttypi newname	(client /dev/ttypi's current
32054e179ddaSchristos						 session and window)
32064e179ddaSchristos	tmux renamew -t/dev/ttypi: newname	(client /dev/ttypi's current
32074e179ddaSchristos						 session and window)
32084e179ddaSchristos	tmux renamew -t/dev/ttypi:0 newname	(client /dev/ttypi's current
32094e179ddaSchristos						 session, window 0)
32104e179ddaSchristos
32114e179ddaSchristos  This does have some downsides, for example, having to use -t on selectw,
32124e179ddaSchristos
32134e179ddaSchristos	tmux selectw -t7
32144e179ddaSchristos
32154e179ddaSchristos  is annoying. But then using non-flagged arguments would mean renaming the
32164e179ddaSchristos  current window would need to be something like:
32174e179ddaSchristos
32184e179ddaSchristos	tmux renamew : newname
32194e179ddaSchristos
32204e179ddaSchristos  It might be better not to try and be so consistent; comments to the usual
32214e179ddaSchristos  address ;-).
32224e179ddaSchristos* Infrastructure for printing arguments in list-keys output. Easy ones only for
32234e179ddaSchristos  now.
32244e179ddaSchristos
32254e179ddaSchristos04 June 2008
32264e179ddaSchristos
32274e179ddaSchristos* Add some vi(1) key bindings in copy mode, and support binding ^[, ^\, ^]
32284e179ddaSchristos  ^^ and ^_. Both from/prompted by Will Maier.
32294e179ddaSchristos* setw monitor-activity and set status without arguments now toggle the current
32304e179ddaSchristos  value; suggested by merdely.
32314e179ddaSchristos* New command set-window-option (alias setw) to set the single current window
32324e179ddaSchristos  option: monitor-activity to determine whether window activity is shown in
32334e179ddaSchristos  the status bar for that window (default off).
32344e179ddaSchristos* Change so active/bell windows are inverted in status line.
32354e179ddaSchristos* Activity monitoring - window with activity are marked in status line. No
32364e179ddaSchristos  way to disable this/filter windows yet.
32374e179ddaSchristos* Brought select-window command into line with everything else; it now uses
32384e179ddaSchristos  -i for the window index.
32394e179ddaSchristos* Strings to display on the left and right of the status bar may now be set
32404e179ddaSchristos  with the status-left and status-right options. These are passed through
32414e179ddaSchristos  strftime(3) before being displayed. The status bar is automatically updated
32424e179ddaSchristos  at an interval set by the status-interval option. The default is to display
32434e179ddaSchristos  nothing on the left and the date and time on the left; the default update
32444e179ddaSchristos  interval is 15 seconds.
32454e179ddaSchristos
32464e179ddaSchristos03 June 2008
32474e179ddaSchristos
32484e179ddaSchristos* Per session options. Setting options without specifying a session sets the
32494e179ddaSchristos  global options as normal (global options are inherited by all sessions);
32504e179ddaSchristos  passing -c or -s will set the option only for that session.
32514e179ddaSchristos* Because a client has a session attached, any command needing a session can
32524e179ddaSchristos  take a client and use its session. So, anything that used to accept -s now
32534e179ddaSchristos  accepts -c as well.
32544e179ddaSchristos* -s to specify session name now supports fnmatch(3) wildcards; if multiple
32554e179ddaSchristos  sessions are found, or if no -s is specified, the most newly created is used.
32564e179ddaSchristos* If no command is specified, assume new-session. As a byproduct, clean up
32574e179ddaSchristos  command default values into separate init functions.
32584e179ddaSchristos* kill-server command.
32594e179ddaSchristos
32604e179ddaSchristos02 June 2008
32614e179ddaSchristos
32624e179ddaSchristos* New command, start-server (alias "start"), to start the tmux server and do
32634e179ddaSchristos  nothing else. This is good if you have a configuration file which creates
32644e179ddaSchristos  windows or sessions (like me): in that case, starting the server the first
32654e179ddaSchristos  time tmux new is run is bad since it creates a new session and window (as
32664e179ddaSchristos  it is supposed to - starting the server is a side-effect).
32674e179ddaSchristos
32684e179ddaSchristos  Instead, I have a little script which does the equivalent of:
32694e179ddaSchristos
32704e179ddaSchristos  	tmux has -s0 2>/dev/null || tmux start
32714e179ddaSchristos  	tmux attach -d -s0
32724e179ddaSchristos
32734e179ddaSchristos  And I use it to start the server if necessary and attach to my primary
32744e179ddaSchristos  session.
32754e179ddaSchristos* Basic configuration file in ~/.tmux.conf or specified with -f. This is file
32764e179ddaSchristos  contains a set of tmux commands that are run the first time the server is
32774e179ddaSchristos  started. The configuration commands are executed before any others, so
32784e179ddaSchristos  if you have a configuration file that contains:
32794e179ddaSchristos
32804e179ddaSchristos	new -d
32814e179ddaSchristos	neww -s0
32824e179ddaSchristos
32834e179ddaSchristos  And you do the following without an existing server running:
32844e179ddaSchristos
32854e179ddaSchristos	tmux new
32864e179ddaSchristos
32874e179ddaSchristos  You will end up with two sessions, session 0 with two windows (created by
32884e179ddaSchristos  the configuration file) and your client attached to session 1 with one
32894e179ddaSchristos  window (created by the command-line command). I'm not completely happy with
32904e179ddaSchristos  this, it seems a little non-obvious, but I haven't yet decided what to do
32914e179ddaSchristos  about it.
32924e179ddaSchristos
32934e179ddaSchristos  There is no environment variable handling or other special stuff yet.
32944e179ddaSchristos
32954e179ddaSchristos  In the future, it might be nice to be able to have per-session configuration
32964e179ddaSchristos  settings, probably by having conditionals in the file (so you could, for
32974e179ddaSchristos  example, have commands to define a particular window layout that would only
32984e179ddaSchristos  be invoked if you called tmux new -smysession and mysession did not already
32994e179ddaSchristos  exist).
33004e179ddaSchristos* BIG CHANGE: -s and -c to specify session name and client name are now passed
33014e179ddaSchristos  after the command rather than before it. So, for example:
33024e179ddaSchristos
33034e179ddaSchristos	tmux -s0 neww
33044e179ddaSchristos
33054e179ddaSchristos  Becomes:
33064e179ddaSchristos
33074e179ddaSchristos	tmux neww -s0
33084e179ddaSchristos
33094e179ddaSchristos  This is to allow them to be used in the (forthcoming) configuration file
33104e179ddaSchristos  THIS WILL BREAK ANY CURRENT SCRIPTS OR ALIASES USING -s OR -c.
33114e179ddaSchristos
33124e179ddaSchristos01 June 2008
33134e179ddaSchristos
33144e179ddaSchristos* Bug fix: don't die if -k passed to link-window and the destination doesn't
33154e179ddaSchristos  exist.
33164e179ddaSchristos* New command, send-keys, will send a set of keys to a window.
33174e179ddaSchristos
33184e179ddaSchristos31 May 2008
33194e179ddaSchristos
33204e179ddaSchristos* Fix so tmux doesn't hang if the initial window fails for some reason. This
33214e179ddaSchristos  was highlighted by problems on Darwin, thanks to Elias Pipping for the report
33224e179ddaSchristos  and access to a test account. (tmux still won't work on Darwin since its
33234e179ddaSchristos  poll(2) is broken.)
33244e179ddaSchristos
33254e179ddaSchristos02 January 2008
33264e179ddaSchristos
33274e179ddaSchristos* Don't attempt to reset the tty on exit if it has been closed externally.
33284e179ddaSchristos
33294e179ddaSchristos06 December 2007
33304e179ddaSchristos
33314e179ddaSchristos* Restore checks for required termcap entries and add a few more obvious
33324e179ddaSchristos  emulations.
33334e179ddaSchristos* Another major reorganisation, this time of screen handling. A new set of
33344e179ddaSchristos  functions, screen_write_*, are now used to write to a screen and a tty
33354e179ddaSchristos  simultaneously. These are used by the input parser to update the base
33364e179ddaSchristos  window screen and also by the different modes which now interpose their own
33374e179ddaSchristos  screen.
33384e179ddaSchristos
33394e179ddaSchristos30 November 2007
33404e179ddaSchristos
33414e179ddaSchristos* Support \ek...\e\ to set window name.
33424e179ddaSchristos
33434e179ddaSchristos27 November 2007
33444e179ddaSchristos
33454e179ddaSchristos* Enable/disable mouse when asked, if terminal claims to support it. Mouse
33464e179ddaSchristos  sequences are just passed through unaltered for the moment.
33474e179ddaSchristos* Big internal reorganisation. Rather than leaving control of the tty solely in
33484e179ddaSchristos  the client and piping all data through a socket to it, change so that the
33494e179ddaSchristos  server opens the tty again and reads and writes to it directly. This avoids
33504e179ddaSchristos  a lot of buffering and copying. Also reorganise the redrawing stuff so that
33514e179ddaSchristos  everything goes through screen_draw_* - this makes the code simpler, but
33524e179ddaSchristos  still needs broken up more, and all the ways of writing to screens should be
33534e179ddaSchristos  more consistent.
33544e179ddaSchristos
33554e179ddaSchristos26 November 2007
33564e179ddaSchristos
33574e179ddaSchristos* Rather than shifting up one line at a time once the history is full,
33584e179ddaSchristos  shift by 10% of the history each time. This is faster.
33594e179ddaSchristos* Add ^A and ^E to copy mode to move to start-of-line/end-of-line.
33604e179ddaSchristos
33614e179ddaSchristos24 November 2007
33624e179ddaSchristos
33634e179ddaSchristos* Support for alt charset mode (VT100 graphics characters).
33644e179ddaSchristos
33654e179ddaSchristos23 November 2007
33664e179ddaSchristos
33674e179ddaSchristos* Mostly complete copy & paste. Copy mode entered with C-b [ (copy-mode
33684e179ddaSchristos  command). In copy mode, arrow keys/page up/page down/hjkl/C-u/C-f navigate,
33694e179ddaSchristos  space or C-space starts selection, and enter or C-w copies and (important!)
33704e179ddaSchristos  exits copy mode. C-b ] (paste-buffer) pastes into current window. No
33714e179ddaSchristos  extra utility keys (bol/eol/clear selection/etc), only one single buffer,
33724e179ddaSchristos  and no buffer manipulation commands (clear/view/etc) yet. The code is also
33734e179ddaSchristos  fugly :-(.
33744e179ddaSchristos* history-limit option to set maximum history. Does not apply retroactively to
33754e179ddaSchristos  existing windows! Lines take up a variable amount of space, but a reasonable
33764e179ddaSchristos  guess for an 80-column terminal is 250 KB per 1000 lines (of history used,
33774e179ddaSchristos  an empty history takes no space).
33784e179ddaSchristos
33794e179ddaSchristos21 November 2007
33804e179ddaSchristos
33814e179ddaSchristos* Create every line as zero length and only expand it as data is written,
33824e179ddaSchristos  rather than creating at full size immediately.
33834e179ddaSchristos* Make command output (eg list-keys) go to a scrollable window similar to
33844e179ddaSchristos  scroll mode.
33854e179ddaSchristos* Redo screen redrawing so it is a) readable b) split into utility functions
33864e179ddaSchristos  that can be used outside screen.c. Use these to make scroll mode only
33874e179ddaSchristos  redraw what it has to which gets rid of irritating flickering status box and
33884e179ddaSchristos  makes it much faster.
33894e179ddaSchristos* Full line width memory and horizontal scrolling in history.
33904e179ddaSchristos* Initial support for scroll history. = to enter scrolling mode, and then
33914e179ddaSchristos  vi keys or up/down/pgup/pgdown to navigate. Q to exit. No horizontal history
33924e179ddaSchristos  yet (need per-line sizes) and a few kinks to be worked out (resizing while in
33934e179ddaSchristos  history mode will probably cause trouble).
33944e179ddaSchristos
33954e179ddaSchristos20 November 2007
33964e179ddaSchristos
33974e179ddaSchristos* Fix format string error with "must specify a client" message. Also
33984e179ddaSchristos  sprinkle some printflike tags.
33994e179ddaSchristos* tmux 0.1 released.
34004e179ddaSchristos
34014e179ddaSchristos17 November 2007
34024e179ddaSchristos
34034e179ddaSchristos* (nicm) Add -k option to link-window to kill target window if it exists.
34044e179ddaSchristos
34054e179ddaSchristos16 November 2007
34064e179ddaSchristos
34074e179ddaSchristos* (nicm) Split in-client display into two columns. This is a hack but not a lot
34084e179ddaSchristos  more so than that bit is already and it helps with lots of keys.
34094e179ddaSchristos* (nicm) switch-client command to switch client between different sessions. This
34104e179ddaSchristos  is pretty cool:
34114e179ddaSchristos
34124e179ddaSchristos	$ tmux bind q switch 0
34134e179ddaSchristos	$ tmux bind w switch 1
34144e179ddaSchristos
34154e179ddaSchristos  Then you can switch between sessions 0 and 1 with a key :-).
34164e179ddaSchristos* (nicm) Accept "-c client-tty" on command line to allow client manipulation
34174e179ddaSchristos  commands, and change detach-/refresh-session to detach-/refresh-client (this
34184e179ddaSchristos  loses the -a behaviour, but at some point -session versions may return, and
34194e179ddaSchristos  -c will allow fnmatch(3)).
34204e179ddaSchristos* (nicm) List available commands on ambiguous command.
34214e179ddaSchristos
34224e179ddaSchristos12 November 2007
34234e179ddaSchristos
34244e179ddaSchristos* (nicm) If the terminal supports default colours (AX present), force black
34254e179ddaSchristos  background and white foreground to default. This is useful on transparent
34264e179ddaSchristos  *terms for programs which don't do it themselves (like most(1)).
34274e179ddaSchristos* (nicm) Fill in the rest of the man page.
34284e179ddaSchristos* (nicm) kill-session command.
34294e179ddaSchristos
34304e179ddaSchristos09 November 2007
34314e179ddaSchristos
34324e179ddaSchristos* (nicm) C-space is now "^ " not "^@".
34334e179ddaSchristos* (nicm) Support tab (\011).
34344e179ddaSchristos* (nicm) Initial man page outline.
34354e179ddaSchristos* (nicm) -V to show version.
34364e179ddaSchristos* (nicm) rename-session command.
34374e179ddaSchristos
34384e179ddaSchristos08 November 2007
34394e179ddaSchristos
34404e179ddaSchristos* (nicm) Check for required terminal capabilities on start.
34414e179ddaSchristos
34424e179ddaSchristos31 October 2007
34434e179ddaSchristos
34444e179ddaSchristos* (nicm) Linux port.
34454e179ddaSchristos
34464e179ddaSchristos30 October 2007
34474e179ddaSchristos
34484e179ddaSchristos* (nicm) swap-window command. Same as link-window but swaps windows.
34494e179ddaSchristos
34504e179ddaSchristos26 October 2007
34514e179ddaSchristos
34524e179ddaSchristos* (nicm) Saving scroll region on \e7 causes problems with ncmpc so I guess
34534e179ddaSchristos  it is not required.
34544e179ddaSchristos* (nicm) unlink-window command.
34554e179ddaSchristos* (nicm) link-window command to link an existing window into another session
34564e179ddaSchristos  (or another index in the same session). Syntax:
34574e179ddaSchristos
34584e179ddaSchristos	tmux -s dstname link-window [-i dstidx] srcname srcidx
34594e179ddaSchristos
34604e179ddaSchristos* (nicm) Redo window data structures. The global array remains, but each per-
34614e179ddaSchristos  session list is now a RB tree of winlink structures. This disassociates the
34624e179ddaSchristos  window index from the array size (allowing arbitrary indexes) which still
34634e179ddaSchristos  allowing windows to have multiple indexes.
34644e179ddaSchristos
34654e179ddaSchristos25 October 2007
34664e179ddaSchristos
34674e179ddaSchristos* (nicm) has-session command: checks if session exists.
34684e179ddaSchristos
34694e179ddaSchristos24 October 2007
34704e179ddaSchristos
34714e179ddaSchristos* (nicm) Support for \e6n to request cursor position. resize(1) now works.
34724e179ddaSchristos* (nicm) Support for \e7, \e8 save/restore cursor and attribute sequences.
34734e179ddaSchristos  Currently don't save mode (probably should). Also change some cases where
34744e179ddaSchristos  out-of-bound values are ignored to limit them to within range (there are
34754e179ddaSchristos  others than need to be checked too).
34764e179ddaSchristos
34774e179ddaSchristos23 October 2007
34784e179ddaSchristos
34794e179ddaSchristos* (nicm) Lift limit on session name passed with -s.
34804e179ddaSchristos* (nicm) Show size in session/window lists.
34814e179ddaSchristos* (nicm) Pass tty up to server when client identifies and add a list-clients
34824e179ddaSchristos  command to list connected clients.
34834e179ddaSchristos
34844e179ddaSchristos20 October 2007
34854e179ddaSchristos
34864e179ddaSchristos* (nicm) Add default-command option and change default to be $SHELL rather than
34874e179ddaSchristos  $SHELL -l. Also try to read shell from passwd db if $SHELL isn't present.
34884e179ddaSchristos
34894e179ddaSchristos19 October 2007
34904e179ddaSchristos
34914e179ddaSchristos* (nicm) -n on new-session is now -s, and -n is now the initial window name.
34924e179ddaSchristos  This was documented but not implemented :-/.
34934e179ddaSchristos* (nicm) kill-window command, bound to & by default (because it should be hard
34946db26757Swiz  to hit accidentally).
34954e179ddaSchristos* (nicm) bell-style option with three choices: "none" completely ignore bell;
34964e179ddaSchristos  "any" pass through a bell in any window to current; "current" ignore bells
34974e179ddaSchristos  except in current window. This applies only to the bell terminal signal,
34984e179ddaSchristos  the status bar always reflects any bells.
34994e179ddaSchristos* (nicm) Refresh session command.
35004e179ddaSchristos
35014e179ddaSchristos12 October 2007
35024e179ddaSchristos
35034e179ddaSchristos* (nicm) Add a warning if $TMUX exists on new/attach.
35044e179ddaSchristos* (nicm) send-prefix command. Bound to C-b by default.
35054e179ddaSchristos* (nicm) set status, status-fg, status-bg commands. fg and bg are as a number
35064e179ddaSchristos  from 0 to 8 or a string ("red", "blue", etc). status may be 1/0, on/off,
35074e179ddaSchristos  yes/no.
35084e179ddaSchristos* (nicm) Make status line mark window in yellow on bell.
35094e179ddaSchristos
35104e179ddaSchristos04 October 2007
35114e179ddaSchristos
35124e179ddaSchristos* (nicm) -d option to attach to detach all other clients on the same session.
35134e179ddaSchristos* (nicm) Partial resizing support. Still buggy. A C-b S and back sometimes fixes
35144e179ddaSchristos  it when it goes wonky.
35154e179ddaSchristos* (mxey) Added my tmux start script as an example (examples/start-tmux.sh).
35164e179ddaSchristos* (mxey) New sessions can now be given a command for their first window.
35174e179ddaSchristos* (mxey) Fixed usage statement for new-window.
35184e179ddaSchristos* (nicm) attach-session (can't believe I forgot it until now!) and list-windows
35194e179ddaSchristos  commands.
35204e179ddaSchristos* (nicm) rename-window and select-window commands.
35214e179ddaSchristos* (nicm) set-option command (alias set): "tmux set-option prefix ^A".
35224e179ddaSchristos* (nicm) Key binding and unbinding is back.
35234e179ddaSchristos
35244e179ddaSchristos03 October 2007
35254e179ddaSchristos
35264e179ddaSchristos* (nicm) {new,next,last,previous}-window.
35274e179ddaSchristos* (nicm) Rewrite command handling so commands are much more generic and the
35284e179ddaSchristos  same commands are used for command line and keys (although most will probably
35294e179ddaSchristos  need to check how they are called). Currently incomplete (only new/detach/ls
35304e179ddaSchristos  implemented). Change: -s is now passed before command again!
35314e179ddaSchristos* (nicm) String number arguments. So you can do: tmux bind ^Q create "blah".
35324e179ddaSchristos* (nicm) Key binding. tmux bind key command [argument] and tmux unbind key.
35334e179ddaSchristos  Key names are in a table in key-string.c, plus A is A, ^A is ctrl-A.
35344e179ddaSchristos  Possible commands are in cmd.c (look at cmd_bind_table).
35354e179ddaSchristos* (nicm) Move command parsing into the client. Also rename some messages and
35364e179ddaSchristos  tidy up a few bits. Lots more tidying up needed :-/.
35374e179ddaSchristos
35384e179ddaSchristos02 October 2007
35394e179ddaSchristos
35404e179ddaSchristos* (nicm) Redraw client status lines on rename.
35414e179ddaSchristos* (nicm) Error on ambiguous command.
35424e179ddaSchristos
35434e179ddaSchristos01 October 2007
35444e179ddaSchristos
35454e179ddaSchristos* (nicm) Restore window title handling.
35464e179ddaSchristos* (nicm) Simple uncustomisable status line with window list.
35474e179ddaSchristos
35484e179ddaSchristos30 September 2007
35494e179ddaSchristos
35504e179ddaSchristos* (nicm) Window info command for debugging, C-b I.
35514e179ddaSchristos
35524e179ddaSchristos29 September 2007
35534e179ddaSchristos
35544e179ddaSchristos* (nicm) Deleting/inserting lines should follow scrolling region. Fix.
35554e179ddaSchristos* (nicm) Allow creation of detached sessions: "tmux new-session -d".
35564e179ddaSchristos* (nicm) Permit error messages to be passed back for transient clients like
35574e179ddaSchristos  rename. Also make rename -i work.
35584e179ddaSchristos* (nicm) Pass through bell in any window to current.
35594e179ddaSchristos
35604e179ddaSchristos28 September 2007
35614e179ddaSchristos
35624e179ddaSchristos* (nicm) Major rewrite of input parser:
35634e179ddaSchristos	- Lose the old weirdness in favour of a state machine.
35644e179ddaSchristos	- Merge in parsing from screen.c.
35654e179ddaSchristos	- Split key parsing off into a separate file.
35664e179ddaSchristos  This is step one towards hopefully allowing a status line. It requires
35674e179ddaSchristos  that we output data as if the terminal had one line less than it really does -
35684e179ddaSchristos  a serious problem when it comes to things like scrolling. This change
35694e179ddaSchristos  consolidates all the range checking and limiting together which should make
35704e179ddaSchristos  it easier.
35714e179ddaSchristos* (mxey) Added window renaming, like "tmux rename [-s session] [-i index] name"
35724e179ddaSchristos
35734e179ddaSchristos27 September 2007
35744e179ddaSchristos
35754e179ddaSchristos* Split "tmux list" into "tmux list-sessions" (ls) and "list-windows" (lsw).
35764e179ddaSchristos* New command session selection:
35774e179ddaSchristos	- if name is specified, look for it and use it if it exists, otherwise
35784e179ddaSchristos	  error
35794e179ddaSchristos	- if no name specified, try the current session from $TMUX
35804e179ddaSchristos	- if $TMUX doesn't exist, and there is only one session, use it,
35814e179ddaSchristos	  otherwise error
35824e179ddaSchristos
35834e179ddaSchristos26 September 2007
35844e179ddaSchristos
35854e179ddaSchristos* Add command aliases, so "ls" is an alias for "list".
35864e179ddaSchristos* Rename some commands and alter syntax to take options after a la CVS. Also
35874e179ddaSchristos  change some flags. So:
35884e179ddaSchristos
35894e179ddaSchristos	tmux -s/socket -nabc new
35904e179ddaSchristos
35914e179ddaSchristos  Becomes:
35924e179ddaSchristos
35934e179ddaSchristos	tmux -S/socket new -sabc
35944e179ddaSchristos
35954e179ddaSchristos* Major tidy and split of client/server code.
35964e179ddaSchristos
35974e179ddaSchristos22 September 2007
35984e179ddaSchristos
35994e179ddaSchristos* Window list command (C-b W). Started by Maximilian Gass, finished by me.
36004e179ddaSchristos
36014e179ddaSchristos20 September 2007
36024e179ddaSchristos
36034e179ddaSchristos* Specify meta via environment variable (META).
36044e179ddaSchristos* Record last window and ^L key to switch to it. Largely from Maximilian Gass.
36054e179ddaSchristos* Reset ignored signals in child after forkpty, makes ^C work.
36064e179ddaSchristos* Wrap on next/previous. From Maximilian Gass.
36074e179ddaSchristos
36084e179ddaSchristos19 September 2007
36094e179ddaSchristos
36104e179ddaSchristos* Don't renumber windows on close.
36114e179ddaSchristos
36124e179ddaSchristos28 August 2007
36134e179ddaSchristos
36144e179ddaSchristos* Scrolling region (\e[r) support.
36154e179ddaSchristos
36164e179ddaSchristos27 August 2007
36174e179ddaSchristos
36184e179ddaSchristos* Change screen.c to work more logically and hopefully fix heap corruption.
36194e179ddaSchristos
36204e179ddaSchristos09 July 2007
36214e179ddaSchristos
36224e179ddaSchristos* Initial import to CVS. Basic functions are working, albeit with a couple of
36234e179ddaSchristos  showstopper memory bugs and many missing features. Detaching, reattaching,
36244e179ddaSchristos  creating new sessions, listing sessions work acceptably for using with shells.
36254e179ddaSchristos  Simple curses programs (top, systat, tetris) and more complicated ones (mutt,
36264e179ddaSchristos  emacs) that don't require scrolling regions (ESC[r) mostly work fine
36274e179ddaSchristos  (including mutt, emacs). No status bar yet and no key remapping or other
36284e179ddaSchristos  customisation.
3629