=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/tmux/tmux.1,v retrieving revision 1.393 retrieving revision 1.394 diff -u -r1.393 -r1.394 --- src/usr.bin/tmux/tmux.1 2014/05/13 07:54:20 1.393 +++ src/usr.bin/tmux/tmux.1 2014/05/13 08:08:32 1.394 @@ -1,4 +1,4 @@ -.\" $OpenBSD: tmux.1,v 1.393 2014/05/13 07:54:20 nicm Exp $ +.\" $OpenBSD: tmux.1,v 1.394 2014/05/13 08:08:32 nicm Exp $ .\" .\" Copyright (c) 2007 Nicholas Marriott .\" @@ -478,11 +478,36 @@ arguments are .Xr sh 1 commands. -These must be passed as a single item, which typically means quoting them, for -example: +This may be a single argument passed to the shell, for example: .Bd -literal -offset indent new-window 'vi /etc/passwd' .Ed +.Pp +Will run: +.Bd -literal -offset indent +/bin/sh -c 'vi /etc/passwd' +.Ed +.Pp +Additionally, the +.Ic new-window , +.Ic new-session , +.Ic split-window , +.Ic respawn-window +and +.Ic respawn-pane +commands allow +.Ar shell-command +to be given as multiple arguments and executed directly (without +.Ql sh -c ) . +This can avoid issues with shell quoting. +For example: +.Bd -literal -offset indent +$ tmux new-window vi /etc/passwd +.Ed +.Pp +Will run +.Xr vi 1 +directly without invoking the shell. .Pp .Ar command .Op Ar arguments