[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.422 and 1.423

version 1.422, 2015/04/21 22:32:40 version 1.423, 2015/04/27 16:25:57
Line 358 
Line 358 
 or  or
 .Ar target-pane .  .Ar target-pane .
 These specify the client, session, window or pane which a command should affect.  These specify the client, session, window or pane which a command should affect.
   .Pp
 .Ar target-client  .Ar target-client
 is the name of the  should be the name of the
 .Xr pty 4  .Xr pty 4
 file to which the client is connected, for example either of  file to which the client is connected, for example either of
 .Pa /dev/ttyp1  .Pa /dev/ttyp1
Line 367 
Line 368 
 .Pa ttyp1  .Pa ttyp1
 for the client attached to  for the client attached to
 .Pa /dev/ttyp1 .  .Pa /dev/ttyp1 .
 If no client is specified, the current client is chosen, if possible, or an  If no client is specified,
 error is reported.  .Nm
   attempts to work out the client currently in use; if that fails, an error is
   reported.
 Clients may be listed with the  Clients may be listed with the
 .Ic list-clients  .Ic list-clients
 command.  command.
 .Pp  .Pp
 .Ar target-session  .Ar target-session
 is the session id prefixed with a $, the name of a session (as listed by the  is tried as, in order:
   .Bl -enum -offset Ds
   .It
   A session ID prefixed with a $.
   .It
   An exact name of a session (as listed by the
 .Ic list-sessions  .Ic list-sessions
 command), or the name of a client with the same syntax as  command).
 .Ar target-client ,  .It
 in which case the session attached to the client is used.  The start of a session name, for example
 When looking for the session name,  .Ql mysess
 .Nm  would match a session named
 initially searches for an exact match; if none is found, the session names  .Ql mysession .
 are checked for any for which  .It
 .Ar target-session  An
 is a prefix or for which it matches as an  
 .Xr fnmatch 3  .Xr fnmatch 3
 pattern.  pattern which is matched against the session name.
 If a single match is found, it is used as the target session; multiple matches  .El
   .Pp
   If a single session is found, it is used as the target session; multiple matches
 produce an error.  produce an error.
 If a session is omitted, the current session is used if available; if no  If a session is omitted, the current session is used if available; if no
 current session is available, the most recently used is chosen.  current session is available, the most recently used is chosen.
Line 400 
Line 409 
 .Ar target-session ,  .Ar target-session ,
 and  and
 .Em window  .Em window
 is looked for in order: as a window index, for example mysession:1;  is looked for in order as:
 as a window ID, such as @1;  .Bl -enum -offset Ds
 as an exact window name, such as mysession:mywindow; then as an  .It
   A special token, listed below.
   .It
   A window index, for example
   .Ql mysession:1
   is window 1 in session
   .Ql mysession .
   .It
   A window ID, such as @1.
   .It
   An exact window name, such as
   .Ql mysession:mywindow .
   .It
   The start of a window name, such as
   .Ql mysession:mywin .
   .It
   As an
 .Xr fnmatch 3  .Xr fnmatch 3
 pattern or the start of a window name, such as mysession:mywin* or  pattern matched against the window name.
 mysession:mywin.  .El
   .Pp
 An empty window name specifies the next unused index if appropriate (for  An empty window name specifies the next unused index if appropriate (for
 example the  example the
 .Ic new-window  .Ic new-window
Line 415 
Line 441 
 otherwise the current window in  otherwise the current window in
 .Em session  .Em session
 is chosen.  is chosen.
 The special character  
 .Ql \&!  
 uses the last (previously current) window,  
 .Ql ^  
 selects the highest numbered window,  
 .Ql $  
 selects the lowest numbered window, and  
 .Ql +  
 and  
 .Ql -  
 select the next window or the previous window by number.  
 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
   The following special tokens are available to indicate particular windows. Each
   has a single-character alternative form.
   .Bl -column "XXXXXXXXXX" "X"
   .It Sy "Token" Ta Sy "" Ta Sy "Meaning"
   .It Li "{start}" Ta "^" Ta "The lowest-numbered window"
   .It Li "{end}" Ta "$" Ta "The highest-numbered window"
   .It Li "{last}" Ta "!" Ta "The last (previously current) window"
   .It Li "{next}" Ta "+" Ta "The next window by number"
   .It Li "{previous}" Ta "-" Ta "The previous window by number"
   .It Li "{mouse}" Ta "=" Ta "The window where the mouse event happened"
   .El
   .Pp
 .Ar target-pane  .Ar target-pane
 takes a similar form to  may be a
   pane ID or takes a similar form to
 .Ar target-window  .Ar target-window
 but with the optional addition of a period followed by a pane index, for  but with the optional addition of a period followed by a pane index or pane ID,
 example: mysession:mywindow.1.  for example:
   .Ql mysession:mywindow.1 .
 If the pane index is omitted, the currently active pane in the specified  If the pane index is omitted, the currently active pane in the specified
 window is used.  window is used.
 If neither a colon nor period appears,  The following special tokens are available for the pane index:
 .Nm  .Bl -column "XXXXXXXXXXXXXX" "X"
 first attempts to use the argument as a pane index; if that fails, it is looked  .It Sy "Token" Ta Sy "" Ta Sy "Meaning"
 up as for  .It Li "{last}" Ta "!" Ta "The last (previously active) pane"
 .Ar target-window .  .It Li "{next}" Ta "+" Ta "The next pane by number"
 A  .It Li "{previous}" Ta "-" Ta "The previous pane by number"
 .Ql + ,  .It Li "{top}" Ta "" Ta "The top pane"
 .Ql -  .It Li "{bottom}" Ta "" Ta "The bottom pane"
 or  .It Li "{left}" Ta "" Ta "The leftmost pane"
 .Ql \&!  .It Li "{right}" Ta "" Ta "The rightmost pane"
 indicate the next, previous or last pane.  .It Li "{top-left}" Ta "" Ta "The top-left pane"
 One of the strings  .It Li "{top-right}" Ta "" Ta "The top-right pane"
 .Em top ,  .It Li "{bottom-left}" Ta "" Ta "The bottom-left pane"
 .Em bottom ,  .It Li "{bottom-right}" Ta "" Ta "The bottom-right pane"
 .Em left ,  .It Li "{up}" Ta "" Ta "The pane above the active pane"
 .Em right ,  .It Li "{down}" Ta "" Ta "The pane below the active pane"
 .Em top-left ,  .It Li "{left}" Ta "" Ta "The pane to the left of the active pane"
 .Em top-right ,  .It Li "{right}" Ta "" Ta "The pane to the right of the active pane"
 .Em bottom-left  .It Li "{mouse}" Ta "=" Ta "The pane where the mouse event happened"
 or  .El
 .Em bottom-right  
 may be used instead of a pane index.  
 .Pp  .Pp
 The special characters  The tokens
 .Ql +  .Ql +
 and  and
 .Ql -  .Ql -
Line 470 
Line 493 
 select-window -t:+2  select-window -t:+2
 .Ed  .Ed
 .Pp  .Pp
 When dealing with a session that doesn't contain sequential window indexes,  Sessions, window and panes are each numbered with a unique ID; session IDs are
 they will be correctly skipped.  prefixed with a
 .Pp  .Ql $ ,
   windows with a
   .Ql @ ,
   and panes with a
   .Ql % .
   These are unique and are unchanged for the life of the session, window or pane
   in the
 .Nm  .Nm
 also gives each pane created in a server an identifier consisting of a  server.
 .Ql %  The pane ID is passed to the child process of the pane in the
 and a number, starting from zero.  
 A pane's identifier is unique for the life of the  
 .Nm  
 server and is passed to the child process of the pane in the  
 .Ev TMUX_PANE  .Ev TMUX_PANE
 environment variable.  environment variable.
 It may be used alone to target a pane or the window containing it.  IDs may be displayed using the
   .Ql session_id ,
   .Ql window_id ,
   or
   .Ql pane_id
   formats (see the
   .Sx FORMATS
   section) and the
   .Ic display-message ,
   .Ic list-sessions ,
   .Ic list-windows
   or
   .Ic list-panes
   commands.
 .Pp  .Pp
 .Ar shell-command  .Ar shell-command
 arguments are  arguments are
Line 3144 
Line 3182 
 Each should be suffixed with a location, for example  Each should be suffixed with a location, for example
 .Ql MouseDown1Status .  .Ql MouseDown1Status .
 .Pp  .Pp
 The special character  The special token
   .Ql {mouse}
   or
 .Ql =  .Ql =
 may be used as  may be used as
 .Ar target-window  .Ar target-window
Legend:
Removed from v.1.422  
changed lines
  Added in v.1.423