[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.824 and 1.825

version 1.824, 2021/02/26 07:53:26 version 1.825, 2021/03/01 10:44:38
Line 522 
Line 522 
 - if a command in the sequence encounters an error, no subsequent commands are  - if a command in the sequence encounters an error, no subsequent commands are
 executed.  executed.
 .Pp  .Pp
   It is recommended that a semicolon used as a command separator should be
   written as an individual token, for example from
   .Xr sh 1 :
   .Bd -literal -offset indent
   $ tmux neww \\; splitw
   .Ed
   .Pp
   Or:
   .Bd -literal -offset indent
   $ tmux neww ';' splitw
   .Ed
   .Pp
   Or from the tmux command prompt:
   .Bd -literal -offset indent
   neww ; splitw
   .Ed
   .Pp
   However, a trailing semicolon is also interpreted as a command separator,
   for example in these
   .Xr sh 1
   commands:
   .Bd -literal -offset indent
   $ tmux neww\\; splitw
   .Ed
   .Pp
   Or:
   .Bd -literal -offset indent
   $ tmux 'neww;' splitw
   .Ed
   .Pp
   As in these examples, when running tmux from the shell extra care must be taken
   to properly quote semicolons:
   .Bl -enum -offset Ds
   .It
   Semicolons that should be interpreted as a command separator
   should be escaped according to the shell conventions.
   For
   .Xr sh 1
   this typically means quoted (such as
   .Ql neww ';' splitw )
   or escaped (such as
   .Ql neww \\\\; splitw ) .
   .It
   Individual semicolons or trailing semicolons that should be interpreted as
   arguments should be escaped twice: once according to the shell conventions and
   a second time for
   .Nm ;
   for example:
   .Bd -literal -offset indent
   $ tmux neww 'foo\\;' bar
   $ tmux neww foo\\\\; bar
   .Ed
   .Pp
   .It
   Semicolons that are not individual tokens or trailing another token should only
   be escaped once according to shell conventions; for example:
   .Bd -literal -offset indent
   $ tmux neww 'foo-;-bar'
   $ tmux neww foo-\\;-bar
   .Ed
   .Pp
   .El
   .Pp
 Comments are marked by the unquoted # character - any remaining text after a  Comments are marked by the unquoted # character - any remaining text after a
 comment is ignored until the end of the line.  comment is ignored until the end of the line.
 .Pp  .Pp
Legend:
Removed from v.1.824  
changed lines
  Added in v.1.825