Add a warning about shell metacharacters, from Nikolas Skarlatos.

This commit is contained in:
nicm
2026-07-28 07:04:18 +00:00
committed by tmux update bot
parent 27ab96b284
commit a5ad1914b8

18
tmux.1
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: tmux.1,v 1.1150 2026/07/27 19:15:58 nicm Exp $ .\" $OpenBSD: tmux.1,v 1.1151 2026/07/28 07:04:18 nicm Exp $
.\" .\"
.\" Copyright (c) 2007 Nicholas Marriott <nicholas.marriott@gmail.com> .\" Copyright (c) 2007 Nicholas Marriott <nicholas.marriott@gmail.com>
.\" .\"
@@ -14,7 +14,7 @@
.\" IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING .\" IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
.\" OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\" .\"
.Dd $Mdocdate: July 27 2026 $ .Dd $Mdocdate: July 28 2026 $
.Dt TMUX 1 .Dt TMUX 1
.Os .Os
.Sh NAME .Sh NAME
@@ -7034,6 +7034,20 @@ escape
command arguments; with command arguments; with
.Ql s .Ql s
use single quotes. use single quotes.
.Pp
Some variables such as
.Ic pane_title
and
.Ic pane_path
are set by escape sequences received from pane and may contain arbitrary
content including shell metacharacters.
.Ql q:\&
should be used to escape these with commands passed to
.Ic run\-shell ,
.Ic if\-shell ,
or
.Ic pipe\-pane .
.Pp
.Ql E:\& .Ql E:\&
will expand the format twice, for example will expand the format twice, for example
.Ql #{E:status\-left} .Ql #{E:status\-left}