[BACK]Return to tmux.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / tmux

Diff for /src/usr.bin/tmux/tmux.1 between version 1.56 and 1.57

version 1.56, 2009/08/04 07:56:38 version 1.57, 2009/08/04 18:41:28
Line 34 
Line 34 
 is a terminal multiplexer: it enables a number of terminals to be accessed and  is a terminal multiplexer: it enables a number of terminals to be accessed and
 controlled from a single terminal.  controlled from a single terminal.
 .Pp  .Pp
 .Nm  
 runs as a server-client system.  
 A server holds a number of  
 .Em sessions ,  
 each of which may have a number of  
 .Em windows  
 linked to it.  
 A server is started automatically when the first session is created and exits  
 when all the sessions it contains are destroyed.  
 A window may be split on screen into one or more  
 .Em panes ,  
 each of which is a separate terminal.  
 Any number of  
 .Em clients  
 may connect to a session, or the server  
 may be controlled by issuing commands with  
 .Nm .  
 Communication takes place through a socket, by default placed in  
 .Pa /tmp .  
 .Pp  
 The options are as follows:  The options are as follows:
 .Bl -tag -width "XXXXXXXXXXXX"  .Bl -tag -width "XXXXXXXXXXXX"
 .It Fl 2  .It Fl 2
Line 151 
Line 131 
 .Ic new-session  .Ic new-session
 command is assumed.  command is assumed.
 .El  .El
 .Sh QUICK START  .Sh INTRODUCTION
 To create a new  
 .Nm  .Nm
 session running  runs as a server-client system.
 .Xr vi 1 :  A server holds a number of
   .Em sessions ,
   each of which may have a number of
   .Em windows
   linked to it.
   A server is started automatically when the first session is created and exits
   when all the sessions it contains are destroyed.
   A window may be split on screen into one or more
   .Em panes ,
   each of which is a separate terminal.
   Any number of
   .Em clients
   may connect to a session, or the server
   may be controlled by issuing commands with
   .Nm .
   Communication takes place through a socket, by default placed in
   .Pa /tmp .
 .Pp  .Pp
 .Dl $ tmux new-session vi  This is an overview of the sections in this manual page:
   .Bl -ohang
   .It Sy Commands
   An overview of how
   .Nm
   commands work.
   .It Sy Clients and sessions
   Commands for managing clients and sessions.
   .It Sy Windows and panes
   Commands for managing windows and panes.
   .It Sy Key bindings
   How key bindings work.
   .It Sy Options
   Configuration options for
   .Nm .
   .It Sy Status line
   Commands pertinent to the status line.
   .It Sy Buffers
   Copy and paste operations.
   .It Sy Miscellaneous
   Miscellaneous commands.
   .It Sy Examples
   A quick start guide.
   .El
   .Sh COMMANDS
   This section contains a list of the commands supported by
   .Nm .
   Most commands accept the optional
   .Fl t
   argument with one of
   .Ar target-client ,
   .Ar target-session
   .Ar target-window ,
   or
   .Ar target-pane .
   These specify the client, session, window or pane which a command should affect.
   .Ar target-client
   is the name of the
   .Xr pty 4
   file to which the client is connected, for example either of
   .Pa /dev/ttyp1
   or
   .Pa ttyp1
   for the client attached to
   .Pa /dev/ttyp1 .
   If no client is specified, the current client is chosen, if possible, or an
   error is reported.
   Clients may be listed with the
   .Ic list-clients
   command.
 .Pp  .Pp
 Most commands have a shorter form, known as an alias.  .Ar target-session
 For new-session, this is  is either the name of a session (as listed by the
 .Ic new :  .Ic list-sessions
   command) or the name of a client with the same syntax as
   .Ar target-client ,
   in which case the session attached to the client is used.
   When looking for the session name,
   .Nm
   initially searches for an exact match; if none is found, the session names
   are checked for any for which
   .Ar target-session
   is a prefix or for which it matches as an
   .Xr fnmatch 3
   pattern.
   If a single match is found, it is used as the target session; multiple matches
   produce an error.
   If a session is omitted, the current session is used if available; if no
   current session is available, the most recently created is chosen.
 .Pp  .Pp
 .Dl $ tmux new vi  .Ar target-window
   specifies a window in the form
   .Em session Ns \&: Ns Em window .
   .Em session
   follows the same rules as for
   .Ar target-session ,
   and
   .Em window
   is looked for in order: as a window index, for example mysession:1; as an exact
   window name, such as mysession:mywindow; then as an
   .Xr fnmatch 3
   pattern or the start of a window name, such as mysession:mywin* or
   mysession:mywin.
   An empty window name specifies the next unused index if appropriate (for
   example the
   .Ic new-window
   and
   .Ic link-window
   commands)
   otherwise the current window in
   .Em session
   is chosen.
   When the argument does not contain a colon,
   .Nm
   first attempts to parse it as window; if that fails, an attempt is made to
   match a session.
 .Pp  .Pp
 Alternatively, the shortest unambiguous form of a command is accepted.  .Ar target-pane
 If there are several options, they are listed:  takes a similar form to
 .Bd -literal -offset indent  .Ar target-window
 $ tmux n  but with the optional addition of a period followed by a pane index, for
 ambiguous command: n, could be: new-session, new-window, next-window  example: mysession:mywindow.1.
 .Ed  If the pane index is omitted, the currently active pane in the specified
 .Pp  window is used.
 Within an active session, a new window may be created by typing  If neither a colon nor period appears,
 .Ql C-b c  
 (Ctrl  
 followed by the  
 .Ql b  
 key  
 followed by the  
 .Ql c  
 key).  
 .Pp  
 Windows may be navigated with:  
 .Ql C-b 0  
 (to select window 0),  
 .Ql C-b 1  
 (to select window 1), and so on;  
 .Ql C-b n  
 to select the next window; and  
 .Ql C-b p  
 to select the previous window.  
 .Pp  
 A session may be detached using  
 .Ql C-b d  
 and reattached with:  
 .Pp  
 .Dl $ tmux attach-session  
 .Pp  
 Typing  
 .Ql C-b \&?  
 lists the current key bindings in the current window; up and down may be used  
 to navigate the list or  
 .Ql q  
 to exit from it.  
 .Pp  
 Commands to be run when the  
 .Nm  .Nm
 server is started may be placed in the  first attempts to use the argument as a pane index; if that fails, it is looked
 .Pa ~/.tmux.conf  up as for
 configuration file.  .Ar target-window .
 Common examples include:  
 .Pp  .Pp
 Changing the default prefix key:  Multiple commands may be specified together as part of a
 .Bd -literal -offset indent  .Em command sequence .
 set-option -g prefix C-a  Each command should be separated by spaces and a semicolon;
 unbind-key C-b  commands are executed sequentially from left to right.
 bind-key C-a send-prefix  A literal semicolon may be included by escaping it with a backslash (for
 .Ed  example, when specifying a command sequence to
   .Ic bind-key ) .
 .Pp  .Pp
 Turning the status line off, or changing its colour:  Examples include:
 .Bd -literal -offset indent  .Bd -literal -offset indent
 set-option -g status off  refresh-client -t/dev/ttyp2
 set-option -g status-bg blue  
   rename-session -tfirst newname
   
   set-window-option -t:0 monitor-activity on
   
   new-window ; split-window -d
   
   bind-key D detach-client \e\; lock-server
 .Ed  .Ed
   .Sh CLIENTS AND SESSIONS
   The following commands are available:
   .Bl -tag -width Ds
   .It Xo Ic attach-session
   .Op Fl d
   .Op Fl t Ar target-session
   .Xc
   .D1 (alias: Ic attach )
   If run from outside
   .Nm ,
   create a new client in the current terminal and attach it to
   .Ar target-session .
   If used from inside, switch the current client.
   If
   .Fl d
   is specified, any other clients attached to the session are detached.
 .Pp  .Pp
 Setting other options, such as the default command,  If no server is started,
 or locking after 30 minutes of inactivity:  .Ic attach-session
 .Bd -literal -offset indent  will attempt to start it; this will fail unless sessions are created in the
 set-option -g default-command "exec /bin/ksh"  configuration file.
 set-option -g lock-after-time 1800  .It Ic detach-client Op Fl t Ar target-client
 .Ed  .D1 (alias: Ic detach )
 .Pp  Detach the current client if bound to a key, or the specified client with
 Creating new key bindings:  .Fl t .
 .Bd -literal -offset indent  .It Ic has-session Op Fl t Ar target-session
 bind-key b set-option status  .D1 (alias: Ic has )
 bind-key / command-prompt "split-window 'exec man %%'"  Report an error and exit with 1 if the specified session does not exist.
 .Ed  If it does exist, exit with 0.
 .Sh KEY BINDINGS  .It Ic kill-server
   Kill the
 .Nm  .Nm
 may be controlled from an attached client by using a key combination of a  server and clients and destroy all sessions.
 prefix key,  .It Ic kill-session Op Fl t Ar target-session
 .Ql C-b  Destroy the given session, closing any windows linked to it and no other
 (Ctrl-b) by default, followed by a command key.  sessions, and detaching all clients attached to it.
 .Pp  .It Ic list-clients
 Some of the default key bindings include:  .D1 (alias: Ic lsc )
 .Pp  List all clients attached to the server.
 .Bl -tag -width Ds -offset 3n -compact  .It Ic list-commands
 .It c  .D1 (alias: Ic lscm )
 Create new window.  List the syntax of all commands supported by
 .It d  .Nm .
 Detach current client.  .It Ic list-sessions
 .It l  .D1 (alias: Ic ls )
 Move to last (previously selected) window in the current session.  List all sessions managed by the server.
 .It n  .It Xo Ic new-session
 Change to next window in the current session.  .Op Fl d
 .It p  .Op Fl n Ar window-name
 Change to previous window in the current session.  .Op Fl s Ar session-name
 .It t  .Op Ar command
 Display a large clock.  .Xc
 .It \&?  .D1 (alias: Ic new )
 List current key bindings.  Create a new session with name
 .El  .Ar session-name .
 .Pp  The new session is attached to the current terminal unless
 A complete list may be obtained with the  .Fl d
 .Ic list-keys  is given.
 command (bound to  .Ar window-name
 .Ql \&?  
 by default).  
 Key bindings may be changed with the  
 .Ic bind-key  
 and  and
 .Ic unbind-key  .Ar command
 commands.  are the name of and command to execute in the initial window.
 .Sh HISTORY  .It Ic refresh-client Op Fl t Ar target-client
   .D1 (alias: Ic refresh )
   Refresh the current client if bound to a key, or a single client if one is given
   with
   .Fl t .
   .It Xo Ic rename-session
   .Op Fl t Ar target-session
   .Ar new-name
   .Xc
   .D1 (alias: Ic rename )
   Rename the session to
   .Ar new-name .
   .It Ic source-file Ar path
   .D1 (alias: Ic source )
   Execute commands from
   .Ar path .
   .It Ic start-server
   .D1 (alias: Ic start )
   Start the
 .Nm  .Nm
 maintains a configurable history buffer for each window.  server, if not already running, without creating any sessions.
 By default, up to 2000 lines are kept; this can be altered with the  .It Xo Ic suspend-client
 .Ic history-limit  .Op Fl c Ar target-client
 option (see the  .Xc
 .Ic set-option  .D1 (alias: Ic suspendc )
 command below).  Suspend a client by sending
 .Sh MODES  .Dv SIGTSTP
   (tty stop).
   .It Xo Ic switch-client
   .Op Fl c Ar target-client
   .Op Fl t Ar target-session
   .Xc
   .D1 (alias: Ic switchc )
   Switch the current session for client
   .Ar target-client
   to
   .Ar target-session .
   .El
   .Sh WINDOWS AND PANES
 A  A
 .Nm  .Nm
 window may be in one of several modes.  window may be in one of several modes.
Line 359 
Line 460 
 .Pp  .Pp
 The paste buffer key pastes the first line from the top paste buffer on the  The paste buffer key pastes the first line from the top paste buffer on the
 stack.  stack.
 .Sh BUFFERS  .Pp
 .Nm  The mode commands are as follows:
 maintains a stack of  .Bl -tag -width Ds
 .Em paste buffers  .It Xo Ic copy-mode
 for each session.  .Op Fl u
 Up to the value of the  .Op Fl t Ar target-window
 .Ic buffer-limit  .Xc
 option are kept; when a new buffer is added, the buffer at the bottom of the  Enter copy mode.
 stack is removed.  The
 Buffers may be added using  .Fl u
   option scrolls one page up.
   .It Xo Ic scroll-mode
   .Op Fl u
   .Op Fl t Ar target-window
   .Xc
   Enter scroll mode.
   The
   .Fl u
   has the same meaning as in the
 .Ic copy-mode  .Ic copy-mode
 or the  
 .Ic set-buffer  
 command, and pasted into a window using the  
 .Ic paste-buffer  
 command.  command.
 .Sh OPTIONS  .El
 The appearance and behaviour of  
 .Nm  
 may be modified by changing the value of various options.  
 There are two types of option:  
 .Em session options  
 and  
 .Em window options .  
 .Pp  .Pp
 Each individual session may have a set of session options, and there is a  
 separate set of global session options.  
 Sessions which do not have a particular option configured inherit the value  
 from the global session options.  
 Session options are set or unset with the  
 .Ic set-option  
 command and may be listed with the  
 .Ic show-options  
 command.  
 The available session options are listed under the  
 .Ic set-option  
 command.  
 .Pp  
 Similarly, a set of window options is attached to each window, and there is  
 a set of global window options from which any unset options are inherited.  
 Window options are altered with the  
 .Ic set-window-option  
 command and can be listed with the  
 .Ic show-window-options  
 command.  
 All window options are documented with the  
 .Ic set-window-option  
 command.  
 .Sh PANES AND LAYOUTS  
 Each window displayed by  Each window displayed by
 .Nm  .Nm
 may be split into one or more  may be split into one or more
Line 470 
Line 545 
 .Em main-pane-width  .Em main-pane-width
 window option.  window option.
 .El  .El
 .Sh STATUS LINE  
 .Nm  
 includes an optional status line which is displayed in the bottom line of each  
 terminal.  
 By default, the status line is enabled (it may be disabled with the  
 .Ic status  
 session option) and contains, from left-to-right: the name of the current  
 session in square brackets; the window list; the current window title in double  
 quotes; and the time and date.  
 .Pp  .Pp
 The status line is made of three parts: configurable left and right sections  Commands related to windows and panes are as follows:
 (which may contain dynamic content such as the time or output from a shell  
 command, see the  
 .Ic status-left ,  
 .Ic status-left-length ,  
 .Ic status-right ,  
 and  
 .Ic status-right-length  
 options below), and a central window list.  
 The window list shows the index, name and (if any) flag of the windows  
 present in the current session in ascending numerical order.  
 The flag is one of the following symbols appended to the window name:  
 .Bl -column "Symbol" "Meaning" -offset indent  
 .It Sy "Symbol" Ta Sy "Meaning"  
 .It Li "*" Ta "Denotes the current window."  
 .It Li "-" Ta "Marks the last window (previously selected)."  
 .It Li "#" Ta "Window is monitored and activity has been detected."  
 .It Li "!" Ta "A bell has occurred in the window."  
 .It Li "+" Ta "Window is monitored for content and it has appeared."  
 .El  
 .Pp  
 The # symbol relates to the  
 .Ic monitor-activity  
 and + to the  
 .Ic monitor-content  
 window options.  
 The window name is printed in inverted colours if an alert (bell, activity or  
 content) is present.  
 .Pp  
 The colour and attributes of the status line may be configured, the entire status line using  
 the  
 .Ic status-attr ,  
 .Ic status-fg  
 and  
 .Ic status-bg  
 session options and individual windows using the  
 .Ic window-status-attr ,  
 .Ic window-status-fg  
 and  
 .Ic window-status-bg  
 window options.  
 .Pp  
 The status line is automatically refreshed at interval if it has changed, the interval may be  
 controlled with the  
 .Ic status-interval  
 session option.  
 .Sh COMMANDS  
 This section contains a list of the commands supported by  
 .Nm .  
 Most commands accept the optional  
 .Fl t  
 argument with one of  
 .Ar target-client ,  
 .Ar target-session  
 .Ar target-window ,  
 or  
 .Ar target-pane .  
 These specify the client, session, window or pane which a command should affect.  
 .Ar target-client  
 is the name of the  
 .Xr pty 4  
 file to which the client is connected, for example either of  
 .Pa /dev/ttyp1  
 or  
 .Pa ttyp1  
 for the client attached to  
 .Pa /dev/ttyp1 .  
 If no client is specified, the current client is chosen, if possible, or an  
 error is reported.  
 Clients may be listed with the  
 .Ic list-clients  
 command.  
 .Pp  
 .Ar target-session  
 is either the name of a session (as listed by the  
 .Ic list-sessions  
 command) or the name of a client with the same syntax as  
 .Ar target-client ,  
 in which case the session attached to the client is used.  
 When looking for the session name,  
 .Nm  
 initially searches for an exact match; if none is found, the session names  
 are checked for any for which  
 .Ar target-session  
 is a prefix or for which it matches as an  
 .Xr fnmatch 3  
 pattern.  
 If a single match is found, it is used as the target session; multiple matches  
 produce an error.  
 If a session is omitted, the current session is used if available; if no  
 current session is available, the most recently created is chosen.  
 .Pp  
 .Ar target-window  
 specifies a window in the form  
 .Em session Ns \&: Ns Em window .  
 .Em session  
 follows the same rules as for  
 .Ar target-session ,  
 and  
 .Em window  
 is looked for in order: as a window index, for example mysession:1; as an exact  
 window name, such as mysession:mywindow; then as an  
 .Xr fnmatch 3  
 pattern or the start of a window name, such as mysession:mywin* or  
 mysession:mywin.  
 An empty window name specifies the next unused index if appropriate (for  
 example the  
 .Ic new-window  
 and  
 .Ic link-window  
 commands)  
 otherwise the current window in  
 .Em session  
 is chosen.  
 When the argument does not contain a colon,  
 .Nm  
 first attempts to parse it as window; if that fails, an attempt is made to  
 match a session.  
 .Pp  
 .Ar target-pane  
 takes a similar form to  
 .Ar target-window  
 but with the optional addition of a period followed by a pane index, for  
 example: mysession:mywindow.1.  
 If the pane index is omitted, the currently active pane in the specified  
 window is used.  
 If neither a colon nor period appears,  
 .Nm  
 first attempts to use the argument as a pane index; if that fails, it is looked  
 up as for  
 .Ar target-window .  
 .Pp  
 Multiple commands may be specified together as part of a  
 .Em command sequence .  
 Each command should be separated by spaces and a semicolon;  
 commands are executed sequentially from left to right.  
 A literal semicolon may be included by escaping it with a backslash (for  
 example, when specifying a command sequence to  
 .Ic bind-key ) .  
 .Pp  
 Examples include:  
 .Bd -literal -offset indent  
 refresh-client -t/dev/ttyp2  
   
 rename-session -tfirst newname  
   
 set-window-option -t:0 monitor-activity on  
   
 new-window ; split-window -d  
   
 bind-key D detach-client \e\; lock-server  
 .Ed  
 .Pp  
 The following commands are available:  
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It Xo Ic attach-session  
 .Op Fl d  
 .Op Fl t Ar target-session  
 .Xc  
 .D1 (alias: Ic attach )  
 If run from outside  
 .Nm ,  
 create a new client in the current terminal and attach it to  
 .Ar target-session .  
 If used from inside, switch the current client.  
 If  
 .Fl d  
 is specified, any other clients attached to the session are detached.  
 .Pp  
 If no server is started,  
 .Ic attach-session  
 will attempt to start it; this will fail unless sessions are created in the  
 configuration file.  
 .It Xo Ic bind-key  
 .Op Fl cnr  
 .Op Fl t Ar key-table  
 .Ar key Ar command Op Ar arguments  
 .Xc  
 .D1 (alias: Ic bind )  
 Bind key  
 .Ar key  
 to  
 .Ar command .  
 Keys may be specified prefixed with  
 .Ql C-  
 or  
 .Ql ^  
 for Ctrl keys, or  
 .Ql M-  
 for Alt (meta) keys.  
 .Pp  
 By default (without  
 .Fl t )  
 the primary key bindings are modified (those normally activated with the prefix  
 key); in this case, if  
 .Fl n  
 is specified, it is not necessary to use the prefix key,  
 .Ar command  
 is bound to  
 .Ar key  
 alone.  
 The  
 .Fl r  
 flag indicates this key may repeat, see the  
 .Ic repeat-time  
 option.  
 .Pp  
 If  
 .Fl t  
 is present,  
 .Ar key  
 is bound in  
 .Ar key-table :  
 the binding for command mode with  
 .Fl c  
 or for normal mode without.  
 To view the default bindings and possible commands, see the  
 .Ic list-keys  
 command.  
 .It Xo Ic break-pane  .It Xo Ic break-pane
 .Op Fl d  .Op Fl d
 .Op Fl t Ar target-pane  .Op Fl t Ar target-pane
Line 720 
Line 569 
 attached to the current client may be selected interactively from a list.  attached to the current client may be selected interactively from a list.
 This command works only from inside  This command works only from inside
 .Nm .  .Nm .
 .It Ic clear-history Op Fl t Ar target-pane  
 .D1 (alias: Ic clearhist )  
 Remove and free the history for the specified pane.  
 .It Ic clock-mode Op Fl t Ar target-window  
 Display a large clock.  
 .It Xo Ic command-prompt  
 .Op Fl t Ar target-client  
 .Op Ar template  
 .Xc  
 Open the command prompt in a client.  
 This may be used from inside  
 .Nm  
 to execute commands interactively.  
 If  
 .Ar template  
 is specified, it is used as the command; any %% in the template will be  
 replaced by what is entered at the prompt.  
 .It Xo Ic confirm-before  
 .Op Fl t Ar target-client  
 .Ar command  
 .Xc  
 .D1 (alias: Ic confirm )  
 Ask for confirmation before executing  
 .Ar command .  
 This command works only from inside  
 .Nm .  
 .It Xo Ic copy-buffer  
 .Op Fl a Ar src-index  
 .Op Fl b Ar dst-index  
 .Op Fl s Ar src-session  
 .Op Fl t Ar dst-session  
 .Xc  
 .D1 (alias: Ic copyb )  
 Copy a session paste buffer to another session.  
 If no sessions are specified, the current one is used instead.  
 .It Xo Ic copy-mode  
 .Op Fl u  
 .Op Fl t Ar target-window  
 .Xc  
 Enter copy mode.  
 The  
 .Fl u  
 option scrolls one page up.  
 .It Xo Ic delete-buffer  
 .Op Fl b Ar buffer-index  
 .Op Fl t Ar target-session  
 .Xc  
 .D1 (alias: Ic deleteb )  
 Delete the buffer at  
 .Ar buffer-index ,  
 or the top buffer if not specified.  
 .It Ic detach-client Op Fl t Ar target-client  
 .D1 (alias: Ic detach )  
 Detach the current client if bound to a key, or the specified client with  
 .Fl t .  
 .It Xo Ic display-message  
 .Op Fl t Ar target-client  
 .Op Ar message  
 .Xc  
 .D1 (alias: Ic display )  
 Display a message (see the  
 .Ic status-left  
 option below)  
 in the status line.  
 .It Ic down-pane Op Fl t Ar target-pane  .It Ic down-pane Op Fl t Ar target-pane
 .D1 (alias: Ic downp )  .D1 (alias: Ic downp )
 Move down a pane.  Move down a pane.
Line 801 
Line 586 
 choice list is shown.  choice list is shown.
 This command only works from inside  This command only works from inside
 .Nm .  .Nm .
 .It Ic has-session Op Fl t Ar target-session  
 .D1 (alias: Ic has )  
 Report an error and exit with 1 if the specified session does not exist.  
 If it does exist, exit with 0.  
 .It Ic if-shell Ar shell-command command  
 .D1 (alias: Ic if )  
 Execute  
 .Ar command  
 if  
 .Ar shell-command  
 returns success.  
 .It Ic kill-pane Op Fl t Ar target-pane  .It Ic kill-pane Op Fl t Ar target-pane
 .D1 (alias: Ic killp )  .D1 (alias: Ic killp )
 Destroy the given pane.  Destroy the given pane.
 If no panes remain in the containing window, it is also destroyed.  If no panes remain in the containing window, it is also destroyed.
 .It Ic kill-server  
 Kill the  
 .Nm  
 server and clients and destroy all sessions.  
 .It Ic kill-session Op Fl t Ar target-session  
 Destroy the given session, closing any windows linked to it and no other  
 sessions, and detaching all clients attached to it.  
 .It Ic kill-window Op Fl t Ar target-window  .It Ic kill-window Op Fl t Ar target-window
 .D1 (alias: Ic killw )  .D1 (alias: Ic killw )
 Kill the current window or the window at  Kill the current window or the window at
Line 857 
Line 624 
 If  If
 .Fl d  .Fl d
 is given, the newly linked window is not selected.  is given, the newly linked window is not selected.
 .It Ic list-buffers Op Fl t Ar target-session  
 .D1 (alias: Ic lsb )  
 List the buffers in the given session.  
 .It Ic list-clients  
 .D1 (alias: Ic lsc )  
 List all clients attached to the server.  
 .It Ic list-commands  
 .D1 (alias: Ic lscm )  
 List the syntax of all commands supported by  
 .Nm .  
 .It Ic list-keys Op Fl t Ar key-table  
 .D1 (alias: Ic lsk )  
 List all key bindings.  
 Without  
 .Fl t  
 the primary key bindings - those executed when preceded by the prefix key -  
 are printed.  
 Keys bound without the prefix key (see  
 .Ic bind-key  
 .Fl n )  
 are enclosed in square brackets.  
 .Pp  
 With  
 .Fl t ,  
 the key bindings in  
 .Ar key-table  
 are listed; this may be one of:  
 .Em vi-edit ,  
 .Em emacs-edit ,  
 .Em vi-choice ,  
 .Em emacs-choice ,  
 .Em vi-copy  
 or  
 .Em emacs-copy .  
 .It Ic list-sessions  
 .D1 (alias: Ic ls )  
 List all sessions managed by the server.  
 .It Ic list-windows Op Fl t Ar target-session  .It Ic list-windows Op Fl t Ar target-session
 .D1 (alias: Ic lsw )  .D1 (alias: Ic lsw )
 List windows in the current session or in  List windows in the current session or in
 .Ar target-session .  .Ar target-session .
 .It Xo Ic load-buffer  
 .Op Fl b Ar buffer-index  
 .Op Fl t Ar target-session  
 .Ar path  
 .Xc  
 .D1 (alias: Ic loadb )  
 Load the contents of the specified paste buffer from  
 .Ar path .  
 .It Ic lock-server  
 .D1 (alias: Ic lock )  
 Lock the server until a password is entered.  
 .It Xo Ic move-window  .It Xo Ic move-window
 .Op Fl d  .Op Fl d
 .Op Fl s Ar src-window  .Op Fl s Ar src-window
Line 921 
Line 640 
 .Ar src-window  .Ar src-window
 is moved to  is moved to
 .Ar dst-window .  .Ar dst-window .
 .It Xo Ic new-session  
 .Op Fl d  
 .Op Fl n Ar window-name  
 .Op Fl s Ar session-name  
 .Op Ar command  
 .Xc  
 .D1 (alias: Ic new )  
 Create a new session with name  
 .Ar session-name .  
 The new session is attached to the current terminal unless  
 .Fl d  
 is given.  
 .Ar window-name  
 and  
 .Ar command  
 are the name of and command to execute in the initial window.  
 .It Xo Ic new-window  .It Xo Ic new-window
 .Op Fl dk  .Op Fl dk
 .Op Fl n Ar window-name  .Op Fl n Ar window-name
Line 982 
Line 685 
 If  If
 .Fl a  .Fl a
 is used, move to the next window with a bell, activity or content alert.  is used, move to the next window with a bell, activity or content alert.
 .It Xo Ic paste-buffer  
 .Op Fl dr  
 .Op Fl b Ar buffer-index  
 .Op Fl t Ar target-window  
 .Xc  
 .D1 (alias: Ic pasteb )  
 Insert the contents of a paste buffer into the current window.  
 With  
 .Fl d ,  
 also delete the paste buffer from the stack.  
 When output, any linefeed (LF) characters in the paste buffer are replaced with  
 carriage returns (CR).  
 This translation may be disabled with the  
 .Fl r  
 flag.  
 .It Xo Ic previous-window  .It Xo Ic previous-window
 .Op Fl a  .Op Fl a
 .Op Fl t Ar target-session  .Op Fl t Ar target-session
Line 1006 
Line 694 
 With  With
 .Fl a ,  .Fl a ,
 move to the previous window with a bell, activity or content alert.  move to the previous window with a bell, activity or content alert.
 .It Ic refresh-client Op Fl t Ar target-client  
 .D1 (alias: Ic refresh )  
 Refresh the current client if bound to a key, or a single client if one is given  
 with  
 .Fl t .  
 .It Xo Ic rename-session  
 .Op Fl t Ar target-session  
 .Ar new-name  
 .Xc  
 .D1 (alias: Ic rename )  
 Rename the session to  
 .Ar new-name .  
 .It Xo Ic rename-window  .It Xo Ic rename-window
 .Op Fl t Ar target-window  .Op Fl t Ar target-window
 .Ar new-name  .Ar new-name
Line 1068 
Line 744 
 lower) with  lower) with
 .Fl U  .Fl U
 or downward (numerically higher).  or downward (numerically higher).
 .It Xo Ic save-buffer  
 .Op Fl a  
 .Op Fl b Ar buffer-index  
 .Op Fl t Ar target-session  
 .Ar path  
 .Xc  
 .D1 (alias: Ic saveb )  
 Save the contents of the specified paste buffer to  
 .Ar path .  
 The  
 .Fl a  
 option appends to rather than overwriting the file.  
 .It Xo Ic scroll-mode  
 .Op Fl u  
 .Op Fl t Ar target-window  
 .Xc  
 Enter scroll mode.  
 The  
 .Fl u  
 has the same meaning as in the  
 .Ic copy-mode  
 command.  
 .It Xo Ic select-layout  .It Xo Ic select-layout
 .Op Fl t Ar target-window  .Op Fl t Ar target-window
 .Op Ar layout-name  .Op Ar layout-name
Line 1105 
Line 759 
 .Ar target-pane  .Ar target-pane
 the active pane in window  the active pane in window
 .Ar target-window .  .Ar target-window .
 .It Ic select-prompt Op Fl t Ar target-client  
 Open a prompt inside  
 .Ar target-client  
 allowing a window index to be entered interactively.  
 .It Ic select-window Op Fl t Ar target-window  .It Ic select-window Op Fl t Ar target-window
 .D1 (alias: Ic selectw )  .D1 (alias: Ic selectw )
 Select the window at  Select the window at
 .Ar target-window .  .Ar target-window .
   .It Xo Ic split-window
   .Op Fl dhv
   .Oo Fl l
   .Ar size |
   .Fl p Ar percentage Oc
   .Op Fl t Ar target-window
   .Op Ar command
   .Xc
   .D1 (alias: splitw )
   Creates a new pane by splitting the active pane:
   .Fl h
   does a horizontal split and
   .Fl v
   a vertical split; if neither is specified,
   .Fl v
   is assumed.
   The
   .Fl l
   and
   .Fl p
   options specify the size of the new window in lines (for vertical split) or in
   cells (for horizontal split), or as a percentage, respectively.
   All other options have the same meaning as in the
   .Ic new-window
   command.
   .It Xo Ic swap-pane
   .Op Fl dDU
   .Op Fl s Ar src-pane
   .Op Fl t Ar dst-pane
   .Xc
   .D1 (alias: Ic swapp )
   Swap two panes.
   If
   .Fl U
   is used and no source pane is specified with
   .Fl s ,
   .Ar dst-pane
   is swapped with the previous pane (before it numerically);
   .Fl D
   swaps with the next pane (after it numerically).
   .It Xo Ic swap-window
   .Op Fl d
   .Op Fl s Ar src-window
   .Op Fl t Ar dst-window
   .Xc
   .D1 (alias: Ic swapw )
   This is similar to
   .Ic link-window ,
   except the source and destination windows are swapped.
   It is an error if no window exists at
   .Ar src-window .
   .It Xo Ic unlink-window
   .Op Fl k
   .Op Fl t Ar target-window
   .Xc
   .D1 (alias: Ic unlinkw )
   Unlink
   .Ar target-window .
   Unless
   .Fl k
   is given, a window may be unlinked only if it is linked to multiple sessions -
   windows may not be linked to no sessions;
   if
   .Fl k
   is specified and the window is linked to only one session, it is unlinked and
   destroyed.
   .It Ic up-pane Op Fl t Ar target-pane
   .D1 (alias: Ic upp )
   Move up a pane.
   .El
   .Sh KEY BINDINGS
   .Nm
   may be controlled from an attached client by using a key combination of a
   prefix key,
   .Ql C-b
   (Ctrl-b) by default, followed by a command key.
   .Pp
   Some of the default key bindings include:
   .Pp
   .Bl -tag -width Ds -offset 3n -compact
   .It c
   Create new window.
   .It d
   Detach current client.
   .It l
   Move to last (previously selected) window in the current session.
   .It n
   Change to next window in the current session.
   .It p
   Change to previous window in the current session.
   .It t
   Display a large clock.
   .It \&?
   List current key bindings.
   .El
   .Pp
   A complete list may be obtained with the
   .Ic list-keys
   command (bound to
   .Ql \&?
   by default).
   Key bindings may be changed with the
   .Ic bind-key
   and
   .Ic unbind-key
   commands.
   .Pp
   Commands related to key bindings are as follows:
   .Bl -tag -width Ds
   .It Xo Ic bind-key
   .Op Fl cnr
   .Op Fl t Ar key-table
   .Ar key Ar command Op Ar arguments
   .Xc
   .D1 (alias: Ic bind )
   Bind key
   .Ar key
   to
   .Ar command .
   Keys may be specified prefixed with
   .Ql C-
   or
   .Ql ^
   for Ctrl keys, or
   .Ql M-
   for Alt (meta) keys.
   .Pp
   By default (without
   .Fl t )
   the primary key bindings are modified (those normally activated with the prefix
   key); in this case, if
   .Fl n
   is specified, it is not necessary to use the prefix key,
   .Ar command
   is bound to
   .Ar key
   alone.
   The
   .Fl r
   flag indicates this key may repeat, see the
   .Ic repeat-time
   option.
   .Pp
   If
   .Fl t
   is present,
   .Ar key
   is bound in
   .Ar key-table :
   the binding for command mode with
   .Fl c
   or for normal mode without.
   To view the default bindings and possible commands, see the
   .Ic list-keys
   command.
   .It Ic list-keys Op Fl t Ar key-table
   .D1 (alias: Ic lsk )
   List all key bindings.
   Without
   .Fl t
   the primary key bindings - those executed when preceded by the prefix key -
   are printed.
   Keys bound without the prefix key (see
   .Ic bind-key
   .Fl n )
   are enclosed in square brackets.
   .Pp
   With
   .Fl t ,
   the key bindings in
   .Ar key-table
   are listed; this may be one of:
   .Em vi-edit ,
   .Em emacs-edit ,
   .Em vi-choice ,
   .Em emacs-choice ,
   .Em vi-copy
   or
   .Em emacs-copy .
 .It Xo Ic send-keys  .It Xo Ic send-keys
 .Op Fl t Ar target-window  .Op Fl t Ar target-window
 .Ar key Ar ...  .Ar key Ar ...
Line 1130 
Line 959 
 All arguments are sent sequentially from first to last.  All arguments are sent sequentially from first to last.
 .It Ic send-prefix Op Fl t Ar target-window  .It Ic send-prefix Op Fl t Ar target-window
 Send the prefix key to a window as if it was pressed.  Send the prefix key to a window as if it was pressed.
 .It Ic server-info  .It Xo Ic unbind-key
 .D1 (alias: Ic info )  .Op Fl cn
 Show server information and terminal details.  .Op Fl t Ar key-table
 .It Xo Ic set-buffer  .Ar key
 .Op Fl b Ar buffer-index  
 .Op Fl t Ar target-session  
 .Ar data  
 .Xc  .Xc
 .D1 (alias: Ic setb )  .D1 (alias: Ic unbind )
 Set the contents of the specified buffer to  Unbind the command bound to
 .Ar data .  .Ar key .
   Without
   .Fl t
   the primary key bindings are modified; in this case, if
   .Fl n
   is specified, the command bound to
   .Ar key
   without a prefix (if any) is removed.
   .Pp
   If
   .Fl t
   is present,
   .Ar key
   in
   .Ar key-table
   is unbound: the binding for command mode with
   .Fl c
   or for normal mode without.
   .El
   .Sh OPTIONS
   The appearance and behaviour of
   .Nm
   may be modified by changing the value of various options.
   There are two types of option:
   .Em session options
   and
   .Em window options .
   .Pp
   Each individual session may have a set of session options, and there is a
   separate set of global session options.
   Sessions which do not have a particular option configured inherit the value
   from the global session options.
   Session options are set or unset with the
   .Ic set-option
   command and may be listed with the
   .Ic show-options
   command.
   The available session options are listed under the
   .Ic set-option
   command.
   .Pp
   Similarly, a set of window options is attached to each window, and there is
   a set of global window options from which any unset options are inherited.
   Window options are altered with the
   .Ic set-window-option
   command and can be listed with the
   .Ic show-window-options
   command.
   All window options are documented with the
   .Ic set-window-option
   command.
   .Pp
   Commands which set options are as follows:
   .Bl -tag -width Ds
 .It Xo Ic set-option  .It Xo Ic set-option
 .Op Fl gu  .Op Fl gu
 .Op Fl t Ar target-session  .Op Fl t Ar target-session
Line 1430 
Line 1309 
 .Ic monitor-content  .Ic monitor-content
 window option is enabled.  window option is enabled.
 .El  .El
 .It Xo Ic set-password  
 .Op Fl c  
 .Ar password  
 .Xc  
 .D1 (alias: Ic pass )  
 Set the server password.  
 If the  
 .Fl c  
 option is given, a pre-encrypted password may be specified.  
 By default, the password is blank, thus any entered password will be accepted  
 when unlocking the server (see the  
 .Ic lock-server  
 command).  
 To prevent variable expansion when an encrypted password is read from a  
 configuration file, enclose it in single quotes (').  
 .It Xo Ic set-window-option  .It Xo Ic set-window-option
 .Op Fl gu  .Op Fl gu
 .Op Fl t Ar target-window  .Op Fl t Ar target-window
Line 1603 
Line 1467 
 function key sequences; these have a number included to indicate modifiers such  function key sequences; these have a number included to indicate modifiers such
 as Shift, Alt or Ctrl.  as Shift, Alt or Ctrl.
 .El  .El
 .It Xo Ic show-buffer  
 .Op Fl b Ar buffer-index  
 .Op Fl t Ar target-session  
 .Xc  
 .D1 (alias: Ic showb )  
 Display the contents of the specified buffer.  
 .It Xo Ic show-options  .It Xo Ic show-options
 .Op Fl g  .Op Fl g
 .Op Fl t Ar target-session  .Op Fl t Ar target-session
Line 1628 
Line 1486 
 or the global window options if  or the global window options if
 .Fl g  .Fl g
 is used.  is used.
 .It Ic source-file Ar path  .El
 .D1 (alias: Ic source )  .Sh STATUS LINE
 Execute commands from  .Nm
 .Ar path .  includes an optional status line which is displayed in the bottom line of each
 .It Xo Ic split-window  terminal.
 .Op Fl dhv  By default, the status line is enabled (it may be disabled with the
 .Oo Fl l  .Ic status
 .Ar size |  session option) and contains, from left-to-right: the name of the current
 .Fl p Ar percentage Oc  session in square brackets; the window list; the current window title in double
 .Op Fl t Ar target-window  quotes; and the time and date.
 .Op Ar command  .Pp
 .Xc  The status line is made of three parts: configurable left and right sections
 .D1 (alias: splitw )  (which may contain dynamic content such as the time or output from a shell
 Creates a new pane by splitting the active pane:  command, see the
 .Fl h  .Ic status-left ,
 does a horizontal split and  .Ic status-left-length ,
 .Fl v  .Ic status-right ,
 a vertical split; if neither is specified,  
 .Fl v  
 is assumed.  
 The  
 .Fl l  
 and  and
 .Fl p  .Ic status-right-length
 options specify the size of the new window in lines (for vertical split) or in  options below), and a central window list.
 cells (for horizontal split), or as a percentage, respectively.  The window list shows the index, name and (if any) flag of the windows
 All other options have the same meaning as in the  present in the current session in ascending numerical order.
 .Ic new-window  The flag is one of the following symbols appended to the window name:
 command.  .Bl -column "Symbol" "Meaning" -offset indent
 .It Ic start-server  .It Sy "Symbol" Ta Sy "Meaning"
 .D1 (alias: Ic start )  .It Li "*" Ta "Denotes the current window."
 Start the  .It Li "-" Ta "Marks the last window (previously selected)."
   .It Li "#" Ta "Window is monitored and activity has been detected."
   .It Li "!" Ta "A bell has occurred in the window."
   .It Li "+" Ta "Window is monitored for content and it has appeared."
   .El
   .Pp
   The # symbol relates to the
   .Ic monitor-activity
   and + to the
   .Ic monitor-content
   window options.
   The window name is printed in inverted colours if an alert (bell, activity or
   content) is present.
   .Pp
   The colour and attributes of the status line may be configured, the entire status line using
   the
   .Ic status-attr ,
   .Ic status-fg
   and
   .Ic status-bg
   session options and individual windows using the
   .Ic window-status-attr ,
   .Ic window-status-fg
   and
   .Ic window-status-bg
   window options.
   .Pp
   The status line is automatically refreshed at interval if it has changed, the interval may be
   controlled with the
   .Ic status-interval
   session option.
   .Pp
   Commands related to the status line are as follows:
   .Bl -tag -width Ds
   .It Xo Ic command-prompt
   .Op Fl t Ar target-client
   .Op Ar template
   .Xc
   Open the command prompt in a client.
   This may be used from inside
 .Nm  .Nm
 server, if not already running, without creating any sessions.  to execute commands interactively.
 .It Xo Ic suspend-client  If
 .Op Fl c Ar target-client  .Ar template
   is specified, it is used as the command; any %% in the template will be
   replaced by what is entered at the prompt.
   .It Xo Ic confirm-before
   .Op Fl t Ar target-client
   .Ar command
 .Xc  .Xc
 .D1 (alias: Ic suspendc )  .D1 (alias: Ic confirm )
 Suspend a client by sending  Ask for confirmation before executing
 .Dv SIGTSTP  .Ar command .
 (tty stop).  This command works only from inside
 .It Xo Ic swap-pane  .Nm .
 .Op Fl dDU  .It Xo Ic display-message
 .Op Fl s Ar src-pane  .Op Fl t Ar target-client
 .Op Fl t Ar dst-pane  .Op Ar message
 .Xc  .Xc
 .D1 (alias: Ic swapp )  .D1 (alias: Ic display )
 Swap two panes.  Display a message (see the
 If  .Ic status-left
 .Fl U  option below)
 is used and no source pane is specified with  in the status line.
 .Fl s ,  .It Ic select-prompt Op Fl t Ar target-client
 .Ar dst-pane  Open a prompt inside
 is swapped with the previous pane (before it numerically);  .Ar target-client
 .Fl D  allowing a window index to be entered interactively.
 swaps with the next pane (after it numerically).  .El
 .It Xo Ic swap-window  .Sh BUFFERS
 .Op Fl d  .Nm
 .Op Fl s Ar src-window  maintains a stack of
 .Op Fl t Ar dst-window  .Em paste buffers
   for each session.
   Up to the value of the
   .Ic buffer-limit
   option are kept; when a new buffer is added, the buffer at the bottom of the
   stack is removed.
   Buffers may be added using
   .Ic copy-mode
   or the
   .Ic set-buffer
   command, and pasted into a window using the
   .Ic paste-buffer
   command.
   .Pp
   A configurable history buffer is also maintained for each window.
   By default, up to 2000 lines are kept; this can be altered with the
   .Ic history-limit
   option (see the
   .Ic set-option
   command above).
   .Pp
   The buffer commands are as follows:
   .Bl -tag -width Ds
   .It Ic clear-history Op Fl t Ar target-pane
   .D1 (alias: Ic clearhist )
   Remove and free the history for the specified pane.
   .It Xo Ic copy-buffer
   .Op Fl a Ar src-index
   .Op Fl b Ar dst-index
   .Op Fl s Ar src-session
   .Op Fl t Ar dst-session
 .Xc  .Xc
 .D1 (alias: Ic swapw )  .D1 (alias: Ic copyb )
 This is similar to  Copy a session paste buffer to another session.
 .Ic link-window ,  If no sessions are specified, the current one is used instead.
 except the source and destination windows are swapped.  .It Xo Ic delete-buffer
 It is an error if no window exists at  .Op Fl b Ar buffer-index
 .Ar src-window .  
 .It Xo Ic switch-client  
 .Op Fl c Ar target-client  
 .Op Fl t Ar target-session  .Op Fl t Ar target-session
 .Xc  .Xc
 .D1 (alias: Ic switchc )  .D1 (alias: Ic deleteb )
 Switch the current session for client  Delete the buffer at
 .Ar target-client  .Ar buffer-index ,
 to  or the top buffer if not specified.
 .Ar target-session .  .It Ic list-buffers Op Fl t Ar target-session
 .It Xo Ic unbind-key  .D1 (alias: Ic lsb )
 .Op Fl cn  List the buffers in the given session.
 .Op Fl t Ar key-table  .It Xo Ic load-buffer
 .Ar key  .Op Fl b Ar buffer-index
   .Op Fl t Ar target-session
   .Ar path
 .Xc  .Xc
 .D1 (alias: Ic unbind )  .D1 (alias: Ic loadb )
 Unbind the command bound to  Load the contents of the specified paste buffer from
 .Ar key .  .Ar path .
 Without  .It Xo Ic paste-buffer
 .Fl t  .Op Fl dr
 the primary key bindings are modified; in this case, if  .Op Fl b Ar buffer-index
 .Fl n  
 is specified, the command bound to  
 .Ar key  
 without a prefix (if any) is removed.  
 .Pp  
 If  
 .Fl t  
 is present,  
 .Ar key  
 in  
 .Ar key-table  
 is unbound: the binding for command mode with  
 .Fl c  
 or for normal mode without.  
 .It Xo Ic unlink-window  
 .Op Fl k  
 .Op Fl t Ar target-window  .Op Fl t Ar target-window
 .Xc  .Xc
 .D1 (alias: Ic unlinkw )  .D1 (alias: Ic pasteb )
 Unlink  Insert the contents of a paste buffer into the current window.
 .Ar target-window .  With
 Unless  .Fl d ,
 .Fl k  also delete the paste buffer from the stack.
 is given, a window may be unlinked only if it is linked to multiple sessions -  When output, any linefeed (LF) characters in the paste buffer are replaced with
 windows may not be linked to no sessions;  carriage returns (CR).
   This translation may be disabled with the
   .Fl r
   flag.
   .It Xo Ic save-buffer
   .Op Fl a
   .Op Fl b Ar buffer-index
   .Op Fl t Ar target-session
   .Ar path
   .Xc
   .D1 (alias: Ic saveb )
   Save the contents of the specified paste buffer to
   .Ar path .
   The
   .Fl a
   option appends to rather than overwriting the file.
   .It Xo Ic set-buffer
   .Op Fl b Ar buffer-index
   .Op Fl t Ar target-session
   .Ar data
   .Xc
   .D1 (alias: Ic setb )
   Set the contents of the specified buffer to
   .Ar data .
   .It Xo Ic show-buffer
   .Op Fl b Ar buffer-index
   .Op Fl t Ar target-session
   .Xc
   .D1 (alias: Ic showb )
   Display the contents of the specified buffer.
   .El
   .Sh MISCELLANEOUS
   .Pp
   Miscellaneous commands are as follows:
   .Bl -tag -width Ds
   .It Ic clock-mode Op Fl t Ar target-window
   Display a large clock.
   .It Ic if-shell Ar shell-command command
   .D1 (alias: Ic if )
   Execute
   .Ar command
 if  if
 .Fl k  .Ar shell-command
 is specified and the window is linked to only one session, it is unlinked and  returns success.
 destroyed.  .It Ic lock-server
 .It Ic up-pane Op Fl t Ar target-pane  .D1 (alias: Ic lock )
 .D1 (alias: Ic upp )  Lock the server until a password is entered.
 Move up a pane.  .It Ic server-info
   .D1 (alias: Ic info )
   Show server information and terminal details.
   .It Xo Ic set-password
   .Op Fl c
   .Ar password
   .Xc
   .D1 (alias: Ic pass )
   Set the server password.
   If the
   .Fl c
   option is given, a pre-encrypted password may be specified.
   By default, the password is blank, thus any entered password will be accepted
   when unlocking the server (see the
   .Ic lock-server
   command).
   To prevent variable expansion when an encrypted password is read from a
   configuration file, enclose it in single quotes (').
 .El  .El
 .Sh FILES  .Sh FILES
 .Bl -tag -width "/etc/tmux.confXXX" -compact  .Bl -tag -width "/etc/tmux.confXXX" -compact
Line 1757 
Line 1724 
 .It Pa /etc/tmux.conf  .It Pa /etc/tmux.conf
 System-wide configuration file.  System-wide configuration file.
 .El  .El
   .Sh EXAMPLES
   To create a new
   .Nm
   session running
   .Xr vi 1 :
   .Pp
   .Dl $ tmux new-session vi
   .Pp
   Most commands have a shorter form, known as an alias.
   For new-session, this is
   .Ic new :
   .Pp
   .Dl $ tmux new vi
   .Pp
   Alternatively, the shortest unambiguous form of a command is accepted.
   If there are several options, they are listed:
   .Bd -literal -offset indent
   $ tmux n
   ambiguous command: n, could be: new-session, new-window, next-window
   .Ed
   .Pp
   Within an active session, a new window may be created by typing
   .Ql C-b c
   (Ctrl
   followed by the
   .Ql b
   key
   followed by the
   .Ql c
   key).
   .Pp
   Windows may be navigated with:
   .Ql C-b 0
   (to select window 0),
   .Ql C-b 1
   (to select window 1), and so on;
   .Ql C-b n
   to select the next window; and
   .Ql C-b p
   to select the previous window.
   .Pp
   A session may be detached using
   .Ql C-b d
   and reattached with:
   .Pp
   .Dl $ tmux attach-session
   .Pp
   Typing
   .Ql C-b \&?
   lists the current key bindings in the current window; up and down may be used
   to navigate the list or
   .Ql q
   to exit from it.
   .Pp
   Commands to be run when the
   .Nm
   server is started may be placed in the
   .Pa ~/.tmux.conf
   configuration file.
   Common examples include:
   .Pp
   Changing the default prefix key:
   .Bd -literal -offset indent
   set-option -g prefix C-a
   unbind-key C-b
   bind-key C-a send-prefix
   .Ed
   .Pp
   Turning the status line off, or changing its colour:
   .Bd -literal -offset indent
   set-option -g status off
   set-option -g status-bg blue
   .Ed
   .Pp
   Setting other options, such as the default command,
   or locking after 30 minutes of inactivity:
   .Bd -literal -offset indent
   set-option -g default-command "exec /bin/ksh"
   set-option -g lock-after-time 1800
   .Ed
   .Pp
   Creating new key bindings:
   .Bd -literal -offset indent
   bind-key b set-option status
   bind-key / command-prompt "split-window 'exec man %%'"
   .Ed
 .Sh SEE ALSO  .Sh SEE ALSO
 .Xr pty 4  .Xr pty 4
 .Sh AUTHORS  .Sh AUTHORS
Legend:
Removed from v.1.56  
changed lines
  Added in v.1.57