version 1.622, 2019/03/15 10:04:13 |
version 1.623, 2019/03/17 19:33:12 |
|
|
with |
with |
.Fl np . |
.Fl np . |
.It Ic message-command-style Ar style |
.It Ic message-command-style Ar style |
Set status line message command style, where |
Set status line message command style. |
.Ar style |
For how to specify |
is a comma-separated list of characteristics to be specified. |
.Ar style , |
.Pp |
see the |
The style format is shared by many options and may be: |
.Sx STYLES |
.Ql bg=colour |
section. |
to set the background colour, |
|
.Ql fg=colour |
|
to set the foreground colour, and a list of attributes as specified below. |
|
.Pp |
|
The colour is one of: |
|
.Ic black , |
|
.Ic red , |
|
.Ic green , |
|
.Ic yellow , |
|
.Ic blue , |
|
.Ic magenta , |
|
.Ic cyan , |
|
.Ic white , |
|
aixterm bright variants (if supported: |
|
.Ic brightred , |
|
.Ic brightgreen , |
|
and so on), |
|
.Ic colour0 |
|
to |
|
.Ic colour255 |
|
from the 256-colour set, |
|
.Ic default |
|
for the default colour (inherited from another option in the case of some options, for example |
|
.Ic window-status-style |
|
inherits from |
|
.Ic status-style ) , |
|
.Ic terminal |
|
for the terminal default colour, or a hexadecimal RGB string such as |
|
.Ql #ffffff . |
|
.Pp |
|
The attributes is either |
|
.Ic none |
|
or a comma-delimited list of one or more of: |
|
.Ic bright |
|
(or |
|
.Ic bold ) , |
|
.Ic dim , |
|
.Ic underscore , |
|
.Ic blink , |
|
.Ic reverse , |
|
.Ic hidden , |
|
.Ic italics , |
|
.Ic strikethrough , |
|
.Ic double-underscore |
|
.Ic curly-underscore |
|
.Ic dotted-underscore |
|
or |
|
.Ic dashed-underscore |
|
to turn an attribute on, or an attribute prefixed with |
|
.Ql no |
|
to turn one off. |
|
.Pp |
|
Examples are: |
|
.Bd -literal -offset indent |
|
fg=yellow,bold,underscore,blink |
|
bg=black,fg=default,noreverse |
|
.Ed |
|
.Pp |
|
With the |
|
.Fl a |
|
flag to the |
|
.Ic set-option |
|
command the new style is added otherwise the existing style is replaced. |
|
.It Ic message-style Ar style |
.It Ic message-style Ar style |
Set status line message style. |
Set status line message style. |
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
.It Xo Ic mouse |
.It Xo Ic mouse |
.Op Ic on | off |
.Op Ic on | off |
.Xc |
.Xc |
|
|
(by default the session name) to the left of the status line. |
(by default the session name) to the left of the status line. |
.Ar string |
.Ar string |
will be passed through |
will be passed through |
.Xr strftime 3 |
.Xr strftime 3 . |
and formats (see |
Also see the |
.Sx FORMATS ) |
.Sx FORMATS |
will be expanded. |
and |
It may also contain the special character sequence #[] to change the colour |
.Sx STYLES |
or attributes, for example |
sections. |
.Ql #[fg=red,bright] |
|
to set a bright red foreground. |
|
See the |
|
.Ic message-command-style |
|
option for a description of colours and attributes. |
|
.Pp |
.Pp |
For details on how the names and titles can be set see the |
For details on how the names and titles can be set see the |
.Sx "NAMES AND TITLES" |
.Sx "NAMES AND TITLES" |
|
|
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
.It Xo Ic status-position |
.It Xo Ic status-position |
.Op Ic top | bottom |
.Op Ic top | bottom |
.Xc |
.Xc |
|
|
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
.It Ic status-style Ar style |
.It Ic status-style Ar style |
Set status line style. |
Set status line style. |
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
.It Ic update-environment[] Ar variable |
.It Ic update-environment[] Ar variable |
Set list of environment variables to be copied into the session environment |
Set list of environment variables to be copied into the session environment |
when a new session is created or an existing session is attached. |
when a new session is created or an existing session is attached. |
|
|
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
.Pp |
.Pp |
.It Xo Ic monitor-activity |
.It Xo Ic monitor-activity |
.Op Ic on | off |
.Op Ic on | off |
|
|
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
Attributes are ignored. |
Attributes are ignored. |
.Pp |
.Pp |
.It Ic pane-base-index Ar index |
.It Ic pane-base-index Ar index |
|
|
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
Attributes are ignored. |
Attributes are ignored. |
.Pp |
.Pp |
.It Xo Ic remain-on-exit |
.It Xo Ic remain-on-exit |
|
|
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
.Pp |
.Pp |
.It Ic window-status-activity-style Ar style |
.It Ic window-status-activity-style Ar style |
Set status line style for windows with an activity alert. |
Set status line style for windows with an activity alert. |
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
.Pp |
.Pp |
.It Ic window-status-bell-style Ar style |
.It Ic window-status-bell-style Ar style |
Set status line style for windows with a bell alert. |
Set status line style for windows with a bell alert. |
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
.Pp |
.Pp |
.It Ic window-status-current-format Ar string |
.It Ic window-status-current-format Ar string |
Like |
Like |
|
|
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
.Pp |
.Pp |
.It Ic window-status-format Ar string |
.It Ic window-status-format Ar string |
Set the format in which the window is displayed in the status line window list. |
Set the format in which the window is displayed in the status line window list. |
See the |
See the |
.Ar status-left |
.Sx FORMATS |
option for details of special character sequences available. |
and |
The default is |
.Sx STYLES |
.Ql #I:#W#F . |
sections. |
.Pp |
.Pp |
.It Ic window-status-last-style Ar style |
.It Ic window-status-last-style Ar style |
Set status line style for the last active window. |
Set status line style for the last active window. |
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
.Pp |
.Pp |
.It Ic window-status-separator Ar string |
.It Ic window-status-separator Ar string |
Sets the separator drawn between windows in the status line. |
Sets the separator drawn between windows in the status line. |
|
|
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
.Pp |
.Pp |
.It Ic window-style Ar style |
.It Ic window-style Ar style |
Set the default window style. |
Set the default window style. |
For how to specify |
For how to specify |
.Ar style , |
.Ar style , |
see the |
see the |
.Ic message-command-style |
.Sx STYLES |
option. |
section. |
.Pp |
.Pp |
.It Xo Ic wrap-search |
.It Xo Ic wrap-search |
.Op Ic on | off |
.Op Ic on | off |
|
|
.It Li "window_zoomed_flag" Ta "" Ta "1 if window is zoomed" |
.It Li "window_zoomed_flag" Ta "" Ta "1 if window is zoomed" |
.It Li "wrap_flag" Ta "" Ta "Pane wrap flag" |
.It Li "wrap_flag" Ta "" Ta "Pane wrap flag" |
.El |
.El |
|
.Sh STYLES |
|
.Nm |
|
offers various options to specify the colour and attributes of aspects of the |
|
interface, for example |
|
.Ic status-style |
|
for the status line. |
|
In addition, embedded styles may be specified in format options, such as |
|
.Ic status-left-format , |
|
by enclosing them in |
|
.Ql #[ |
|
and |
|
.Ql ] . |
|
.Pp |
|
A style may be the single term |
|
.Ql default |
|
to specify the default style (which may inherit from another option) or a space |
|
separated list of the following: |
|
.Bl -tag -width Ds |
|
.It Ic fg=colour |
|
Set the foreground colour. |
|
The colour is one of: |
|
.Ic black , |
|
.Ic red , |
|
.Ic green , |
|
.Ic yellow , |
|
.Ic blue , |
|
.Ic magenta , |
|
.Ic cyan , |
|
.Ic white ; |
|
if supported the bright variants |
|
.Ic brightred , |
|
.Ic brightgreen , |
|
.Ic brightyellow ; |
|
.Ic colour0 |
|
to |
|
.Ic colour255 |
|
from the 256-colour set; |
|
.Ic default |
|
for the default colour; |
|
.Ic terminal |
|
for the terminal default colour; or a hexadecimal RGB string such as |
|
.Ql #ffffff . |
|
.It Ic bg=colour |
|
Set the background colour. |
|
.It Ic none |
|
Set no attributes (turn off any active attributes). |
|
.It Xo Ic bright (or |
|
.Ic bold ) |
|
.Ic dim , |
|
.Ic underscore , |
|
.Ic blink , |
|
.Ic reverse , |
|
.Ic hidden , |
|
.Ic italics , |
|
.Ic strikethrough , |
|
.Ic double-underscore , |
|
.Ic curly-underscore , |
|
.Ic dotted-underscore , |
|
.Ic dashed-underscore |
|
.Xc |
|
Set an attribute. |
|
Any of the attributes may be prefixed with |
|
.Ql no |
|
to unset. |
|
.El |
|
.Pp |
|
Examples are: |
|
.Bd -literal -offset indent |
|
fg=yellow,bold,underscore,blink |
|
bg=black,fg=default,noreverse |
|
.Ed |
.Sh NAMES AND TITLES |
.Sh NAMES AND TITLES |
.Nm |
.Nm |
distinguishes between names and titles. |
distinguishes between names and titles. |