version 1.677, 2019/07/10 11:20:10 |
version 1.678, 2019/07/19 07:18:03 |
|
|
.Fl s ) |
.Fl s ) |
argument with one of |
argument with one of |
.Ar target-client , |
.Ar target-client , |
.Ar target-session |
.Ar target-session , |
.Ar target-window , |
.Ar target-window , |
or |
or |
.Ar target-pane . |
.Ar target-pane . |
|
|
.Ql {mouse} |
.Ql {mouse} |
(alternative form |
(alternative form |
.Ql = ) |
.Ql = ) |
to specify the most recent mouse event |
to specify the session, window or pane where the most recent mouse event occurred |
(see the |
(see the |
.Sx MOUSE SUPPORT |
.Sx MOUSE SUPPORT |
section) |
section) |
|
|
.Ic list-keys , |
.Ic list-keys , |
is executed from a key binding. |
is executed from a key binding. |
.Pp |
.Pp |
|
In copy mode an indicator is displayed in the top-right corner of the pane with |
|
the current position and the number of lines in the history. |
|
.Pp |
Commands are sent to copy mode using the |
Commands are sent to copy mode using the |
.Fl X |
.Fl X |
flag to the |
flag to the |
|
|
.It Li "jump-to-backward <to>" Ta "T" Ta "" |
.It Li "jump-to-backward <to>" Ta "T" Ta "" |
.It Li "jump-to-forward <to>" Ta "t" Ta "" |
.It Li "jump-to-forward <to>" Ta "t" Ta "" |
.It Li "middle-line" Ta "M" Ta "M-r" |
.It Li "middle-line" Ta "M" Ta "M-r" |
|
.It Li "next-matching-bracket" Ta "%" Ta "M-C-f" |
.It Li "next-paragraph" Ta "}" Ta "M-}" |
.It Li "next-paragraph" Ta "}" Ta "M-}" |
.It Li "next-space" Ta "W" Ta "" |
.It Li "next-space" Ta "W" Ta "" |
.It Li "next-space-end" Ta "E" Ta "" |
.It Li "next-space-end" Ta "E" Ta "" |
|
|
.It Li "page-down" Ta "C-f" Ta "PageDown" |
.It Li "page-down" Ta "C-f" Ta "PageDown" |
.It Li "page-down-and-cancel" Ta "" Ta "" |
.It Li "page-down-and-cancel" Ta "" Ta "" |
.It Li "page-up" Ta "C-b" Ta "PageUp" |
.It Li "page-up" Ta "C-b" Ta "PageUp" |
|
.It Li "previous-matching-bracket" Ta "" Ta "M-C-b" |
.It Li "previous-paragraph" Ta "{" Ta "M-{" |
.It Li "previous-paragraph" Ta "{" Ta "M-{" |
.It Li "previous-space" Ta "B" Ta "" |
.It Li "previous-space" Ta "B" Ta "" |
.It Li "previous-word" Ta "b" Ta "M-b" |
.It Li "previous-word" Ta "b" Ta "M-b" |
|
|
The terminal entry value is passed through |
The terminal entry value is passed through |
.Xr strunvis 3 |
.Xr strunvis 3 |
before interpretation. |
before interpretation. |
|
.It Ic user-keys[] Ar key |
|
Set list of user-defined key escape sequences. |
|
Each item is associated with a key named |
|
.Ql User0 , |
|
.Ql User1 , |
|
and so on. |
|
.Pp |
|
For example: |
|
.Bd -literal -offset indent |
|
set -s user-keys[0] "\ee[5;30012~" |
|
bind User0 resize-pane -L 3 |
|
.Ed |
.El |
.El |
.Pp |
.Pp |
Available session options are: |
Available session options are: |
|
|
.Xr xterm 1 . |
.Xr xterm 1 . |
This option is off by default. |
This option is off by default. |
.It Ic set-titles-string Ar string |
.It Ic set-titles-string Ar string |
String used to set the window title if |
String used to set the client terminal title if |
.Ic set-titles |
.Ic set-titles |
is on. |
is on. |
Formats are expanded, see the |
Formats are expanded, see the |
|
|
was given to the |
was given to the |
.Ic set-environment |
.Ic set-environment |
command). |
command). |
.It Ic user-keys[] Ar key |
|
Set list of user-defined key escape sequences. |
|
Each item is associated with a key named |
|
.Ql User0 , |
|
.Ql User1 , |
|
and so on. |
|
.Pp |
|
For example: |
|
.Bd -literal -offset indent |
|
set -s user-keys[0] "\ee[5;30012~" |
|
bind User0 resize-pane -L 3 |
|
.Ed |
|
.It Xo Ic visual-activity |
.It Xo Ic visual-activity |
.Op Ic on | off | both |
.Op Ic on | off | both |
.Xc |
.Xc |
|
|
.Ar format |
.Ar format |
argument. |
argument. |
This is a string which controls the output format of the command. |
This is a string which controls the output format of the command. |
Replacement variables are enclosed in |
Format variables are enclosed in |
.Ql #{ |
.Ql #{ |
and |
and |
.Ql } , |
.Ql } , |
|
|
#{?pane_in_mode,#[fg=white#,bg=red],#[fg=red#,bg=white]}#W . |
#{?pane_in_mode,#[fg=white#,bg=red],#[fg=red#,bg=white]}#W . |
.Ed |
.Ed |
.Pp |
.Pp |
Comparisons may be expressed by prefixing two comma-separated |
String comparisons may be expressed by prefixing two comma-separated |
alternatives by |
alternatives by |
.Ql == , |
.Ql == , |
.Ql != , |
.Ql != , |
|
|
The following variables are available, where appropriate: |
The following variables are available, where appropriate: |
.Bl -column "XXXXXXXXXXXXXXXXXXX" "XXXXX" |
.Bl -column "XXXXXXXXXXXXXXXXXXX" "XXXXX" |
.It Sy "Variable name" Ta Sy "Alias" Ta Sy "Replaced with" |
.It Sy "Variable name" Ta Sy "Alias" Ta Sy "Replaced with" |
.It Li "alternate_on" Ta "" Ta "If pane is in alternate screen" |
.It Li "alternate_on" Ta "" Ta "1 if pane is in alternate screen" |
.It Li "alternate_saved_x" Ta "" Ta "Saved cursor X in alternate screen" |
.It Li "alternate_saved_x" Ta "" Ta "Saved cursor X in alternate screen" |
.It Li "alternate_saved_y" Ta "" Ta "Saved cursor Y in alternate screen" |
.It Li "alternate_saved_y" Ta "" Ta "Saved cursor Y in alternate screen" |
.It Li "buffer_created" Ta "" Ta "Time buffer created" |
.It Li "buffer_created" Ta "" Ta "Time buffer created" |
|
|
.It Li "pane_format" Ta "" Ta "1 if format is for a pane (not assuming the current)" |
.It Li "pane_format" Ta "" Ta "1 if format is for a pane (not assuming the current)" |
.It Li "pane_height" Ta "" Ta "Height of pane" |
.It Li "pane_height" Ta "" Ta "Height of pane" |
.It Li "pane_id" Ta "#D" Ta "Unique pane ID" |
.It Li "pane_id" Ta "#D" Ta "Unique pane ID" |
.It Li "pane_in_mode" Ta "" Ta "If pane is in a mode" |
.It Li "pane_in_mode" Ta "" Ta "1 if pane is in a mode" |
.It Li "pane_index" Ta "#P" Ta "Index of pane" |
.It Li "pane_index" Ta "#P" Ta "Index of pane" |
.It Li "pane_input_off" Ta "" Ta "If input to pane is disabled" |
.It Li "pane_input_off" Ta "" Ta "1 if input to pane is disabled" |
.It Li "pane_left" Ta "" Ta "Left of pane" |
.It Li "pane_left" Ta "" Ta "Left of pane" |
.It Li "pane_marked" Ta "" Ta "1 if this is the marked pane" |
.It Li "pane_marked" Ta "" Ta "1 if this is the marked pane" |
.It Li "pane_marked_set" Ta "" Ta "1 if a marked pane is set" |
.It Li "pane_marked_set" Ta "" Ta "1 if a marked pane is set" |
.It Li "pane_mode" Ta "" Ta "Name of pane mode, if any." |
.It Li "pane_mode" Ta "" Ta "Name of pane mode, if any" |
.It Li "pane_pid" Ta "" Ta "PID of first process in pane" |
.It Li "pane_pid" Ta "" Ta "PID of first process in pane" |
.It Li "pane_pipe" Ta "" Ta "1 if pane is being piped" |
.It Li "pane_pipe" Ta "" Ta "1 if pane is being piped" |
.It Li "pane_right" Ta "" Ta "Right of pane" |
.It Li "pane_right" Ta "" Ta "Right of pane" |
.It Li "pane_search_string" Ta "" Ta "Last search string in copy mode" |
.It Li "pane_search_string" Ta "" Ta "Last search string in copy mode" |
.It Li "pane_start_command" Ta "" Ta "Command pane started with" |
.It Li "pane_start_command" Ta "" Ta "Command pane started with" |
.It Li "pane_synchronized" Ta "" Ta "If pane is synchronized" |
.It Li "pane_synchronized" Ta "" Ta "1 if pane is synchronized" |
.It Li "pane_tabs" Ta "" Ta "Pane tab positions" |
.It Li "pane_tabs" Ta "" Ta "Pane tab positions" |
.It Li "pane_title" Ta "#T" Ta "Title of pane" |
.It Li "pane_title" Ta "#T" Ta "Title of pane" |
.It Li "pane_top" Ta "" Ta "Top of pane" |
.It Li "pane_top" Ta "" Ta "Top of pane" |
|
|
Commands related to the status line are as follows: |
Commands related to the status line are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Xo Ic command-prompt |
.It Xo Ic command-prompt |
.Op Fl 1i |
.Op Fl 1Ni |
.Op Fl I Ar inputs |
.Op Fl I Ar inputs |
.Op Fl p Ar prompts |
.Op Fl p Ar prompts |
.Op Fl t Ar target-client |
.Op Fl t Ar target-client |
|
|
.Fl 1 |
.Fl 1 |
makes the prompt only accept one key press, in this case the resulting input |
makes the prompt only accept one key press, in this case the resulting input |
is a single character. |
is a single character. |
|
.Fl N |
|
makes the prompt only accept numeric key presses. |
.Fl i |
.Fl i |
executes the command every time the prompt input changes instead of when the |
executes the command every time the prompt input changes instead of when the |
user exits the command prompt. |
user exits the command prompt. |
|
|
.Bl -column "FunctionXXXXXXXXXXXXXXXXXXXXXXXXX" "viXXXX" "emacsX" -offset indent |
.Bl -column "FunctionXXXXXXXXXXXXXXXXXXXXXXXXX" "viXXXX" "emacsX" -offset indent |
.It Sy "Function" Ta Sy "vi" Ta Sy "emacs" |
.It Sy "Function" Ta Sy "vi" Ta Sy "emacs" |
.It Li "Cancel command prompt" Ta "Escape" Ta "Escape" |
.It Li "Cancel command prompt" Ta "Escape" Ta "Escape" |
.It Li "Delete current word" Ta "" Ta "C-w" |
.It Li "Delete from cursor to start of word" Ta "" Ta "C-w" |
.It Li "Delete entire command" Ta "d" Ta "C-u" |
.It Li "Delete entire command" Ta "d" Ta "C-u" |
.It Li "Delete from cursor to end" Ta "D" Ta "C-k" |
.It Li "Delete from cursor to end" Ta "D" Ta "C-k" |
.It Li "Execute command" Ta "Enter" Ta "Enter" |
.It Li "Execute command" Ta "Enter" Ta "Enter" |
|
|
.Ar target-pane |
.Ar target-pane |
if |
if |
.Fl t |
.Fl t |
is given, otherwise the active pane for the session attached to |
is given, otherwise the active pane. |
.Ar target-client . |
|
.Pp |
.Pp |
.Fl v |
.Fl v |
prints verbose logging as the format is parsed and |
prints verbose logging as the format is parsed and |