version 1.639, 2019/04/25 15:35:07 |
version 1.640, 2019/04/26 11:38:51 |
|
|
as Shift, Alt or Ctrl. |
as Shift, Alt or Ctrl. |
.El |
.El |
.It Xo Ic show-options |
.It Xo Ic show-options |
.Op Fl gqsvw |
.Op Fl gHqsvw |
.Op Fl t Ar target-session | Ar target-window |
.Op Fl t Ar target-session | Ar target-window |
.Op Ar option |
.Op Ar option |
.Xc |
.Xc |
|
|
is set, no error will be returned if |
is set, no error will be returned if |
.Ar option |
.Ar option |
is unset. |
is unset. |
|
.Fl H |
|
includes hooks (omitted by default). |
.It Xo Ic show-window-options |
.It Xo Ic show-window-options |
.Op Fl gv |
.Op Fl gv |
.Op Fl t Ar target-window |
.Op Fl t Ar target-window |
|
|
.Em after |
.Em after |
hook and there are a number of hooks not associated with commands. |
hook and there are a number of hooks not associated with commands. |
.Pp |
.Pp |
|
Hooks are stored as array options, members of the array are executed in |
|
order when the hook is triggered. |
|
Hooks may be configured with the |
|
.Ic set-hook |
|
or |
|
.Ic set-option |
|
commands and displayed with |
|
.Ic show-hooks |
|
or |
|
.Ic show-options |
|
.Fl H . |
|
The following two commands are equivalent: |
|
.Bd -literal -offset indent. |
|
set-hook -g pane-mode-changed[42] 'set -g status-left-style bg=red' |
|
set-option -g pane-mode-changed[42] 'set -g status-left-style bg=red' |
|
.Ed |
|
.Pp |
|
Setting a hook without specifying an array index clears the hook and sets the |
|
first member of the array. |
|
.Pp |
A command's after |
A command's after |
hook is run after it completes, except when the command is run as part of a hook |
hook is run after it completes, except when the command is run as part of a hook |
itself. |
itself. |
|
|
layout after every |
layout after every |
.Ic split-window : |
.Ic split-window : |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
set-hook after-split-window "selectl even-vertical" |
set-hook -g after-split-window "selectl even-vertical" |
.Ed |
.Ed |
.Pp |
.Pp |
All the notifications listed in the |
All the notifications listed in the |
|
|
Hooks are managed with these commands: |
Hooks are managed with these commands: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Xo Ic set-hook |
.It Xo Ic set-hook |
.Op Fl gRu |
.Op Fl agRu |
.Op Fl t Ar target-session |
.Op Fl t Ar target-session |
.Ar hook-name |
.Ar hook-name |
.Ar command |
.Ar command |
|
|
.Ar target-session |
.Ar target-session |
with |
with |
.Fl t ) . |
.Fl t ) . |
|
.Fl a |
|
appends to a hook. |
Like options, session hooks inherit from the global ones. |
Like options, session hooks inherit from the global ones. |
.Pp |
.Pp |
With |
With |