Add %if/%endif for conditionals when parsing configuration files, the

argument is a format (the new == and != are useful).

1 files changed, 24 insertions, 0 deletions

diff --git a/tmux.1 b/tmux.1
index 04eb9de9..8f1a251f 100644
--- a/tmux.1
+++ b/tmux.1
@@ -930,6 +930,30 @@ If
 is given, no error will be returned if
 .Ar path
 does not exist.
+.Pp
+Within a configuration file, commands may be made conditional by surrounding
+them with
+.Em %if
+and
+.Em %endif
+lines.
+The argument to
+.Em %if
+is expanded as a format and if it evaluates to false
+.Ns ( Ql 0
+or empty), subsequent lines are ignored until
+.Em %endif .
+For example:
+.Bd -literal -offset indent
+%if #{==:#{host},myhost}
+set -g status-style bg=red
+%endif
+.Ed
+.Pp
+Will change the status line to red if running on
+.Ql myhost .
+.Em %if
+may not be nested.
 .It Ic start-server
 .D1 (alias: Ic start )
 Start the