Document escaping inside conditionals, from "sadie-parayno" in GitHub

issue 1359.

1 files changed, 15 insertions, 0 deletions

diff --git a/tmux.1 b/tmux.1
index ee50a9fa..f9d7cb98 100644
--- a/tmux.1
+++ b/tmux.1
@@ -3574,6 +3574,21 @@ if
 is enabled, or
 .Ql no
 if not.
+Conditionals can be nested arbitrarily.
+Inside a conditional,
+.Ql \&,
+and
+.Ql }
+must be escaped as
+.Ql #,
+and
+.Ql #} ,
+unless they are part of a
+.Ql #{...}
+replacement. For example:
+.Bd -literal -offset indent
+#{?pane_in_mode,#[fg=white#,bg=red],#[fg=red#,bg=white]}#W .
+.Ed
 .Pp
 Comparisons may be expressed by prefixing two comma-separated
 alternatives by