mirror of
https://github.com/tmux/tmux.git
synced 2025-09-03 14:27:09 +00:00
Merge branch 'obsd-master'
This commit is contained in:
Thomas Adam
235
tmux.1
235
tmux.1
@ -2837,82 +2837,19 @@ The default is to run
|
||||
with
|
||||
.Fl np .
|
||||
.It Ic message-command-style Ar style
|
||||
Set status line message command style, where
|
||||
.Ar style
|
||||
is a comma-separated list of characteristics to be specified.
|
||||
.Pp
|
||||
The style format is shared by many options and may be:
|
||||
.Ql bg=colour
|
||||
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.
|
||||
Set status line message command style.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Sx STYLES
|
||||
section.
|
||||
.It Ic message-style Ar style
|
||||
Set status line message style.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
.It Xo Ic mouse
|
||||
.Op Ic on | off
|
||||
.Xc
|
||||
@ -3019,17 +2956,12 @@ Display
|
||||
(by default the session name) to the left of the status line.
|
||||
.Ar string
|
||||
will be passed through
|
||||
.Xr strftime 3
|
||||
and formats (see
|
||||
.Sx FORMATS )
|
||||
will be expanded.
|
||||
It may also contain the special character sequence #[] to change the colour
|
||||
or attributes, for example
|
||||
.Ql #[fg=red,bright]
|
||||
to set a bright red foreground.
|
||||
See the
|
||||
.Ic message-command-style
|
||||
option for a description of colours and attributes.
|
||||
.Xr strftime 3 .
|
||||
Also see the
|
||||
.Sx FORMATS
|
||||
and
|
||||
.Sx STYLES
|
||||
sections.
|
||||
.Pp
|
||||
For details on how the names and titles can be set see the
|
||||
.Sx "NAMES AND TITLES"
|
||||
@ -3053,8 +2985,8 @@ Set the style of the left part of the status line.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
.It Xo Ic status-position
|
||||
.Op Ic top | bottom
|
||||
.Xc
|
||||
@ -3081,15 +3013,15 @@ Set the style of the right part of the status line.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
.It Ic status-style Ar style
|
||||
Set status line style.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
.It Ic update-environment[] Ar variable
|
||||
Set list of environment variables to be copied into the session environment
|
||||
when a new session is created or an existing session is attached.
|
||||
@ -3266,8 +3198,8 @@ Set window modes style.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
.Pp
|
||||
.It Xo Ic monitor-activity
|
||||
.Op Ic on | off
|
||||
@ -3315,8 +3247,8 @@ Set the pane border style for the currently active pane.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
Attributes are ignored.
|
||||
.Pp
|
||||
.It Ic pane-base-index Ar index
|
||||
@ -3337,8 +3269,8 @@ Set the pane border style for panes aside from the active pane.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
Attributes are ignored.
|
||||
.Pp
|
||||
.It Xo Ic remain-on-exit
|
||||
@ -3361,24 +3293,24 @@ Set the style for the window's active pane.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
.Pp
|
||||
.It Ic window-status-activity-style Ar style
|
||||
Set status line style for windows with an activity alert.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
.Pp
|
||||
.It Ic window-status-bell-style Ar style
|
||||
Set status line style for windows with a bell alert.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
.Pp
|
||||
.It Ic window-status-current-format Ar string
|
||||
Like
|
||||
@ -3390,24 +3322,24 @@ Set status line style for the currently active window.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
.Pp
|
||||
.It Ic window-status-format Ar string
|
||||
Set the format in which the window is displayed in the status line window list.
|
||||
See the
|
||||
.Ar status-left
|
||||
option for details of special character sequences available.
|
||||
The default is
|
||||
.Ql #I:#W#F .
|
||||
.Sx FORMATS
|
||||
and
|
||||
.Sx STYLES
|
||||
sections.
|
||||
.Pp
|
||||
.It Ic window-status-last-style Ar style
|
||||
Set status line style for the last active window.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
.Pp
|
||||
.It Ic window-status-separator Ar string
|
||||
Sets the separator drawn between windows in the status line.
|
||||
@ -3418,8 +3350,8 @@ Set status line style for a single window.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
.Pp
|
||||
.It Xo Ic Ic window-size
|
||||
.Ar largest | Ar smallest | Ar manual
|
||||
@ -3448,8 +3380,8 @@ Set the default window style.
|
||||
For how to specify
|
||||
.Ar style ,
|
||||
see the
|
||||
.Ic message-command-style
|
||||
option.
|
||||
.Sx STYLES
|
||||
section.
|
||||
.Pp
|
||||
.It Xo Ic wrap-search
|
||||
.Op Ic on | off
|
||||
@ -3978,6 +3910,7 @@ The following variables are available, where appropriate:
|
||||
.It Li "window_active" Ta "" Ta "1 if window active"
|
||||
.It Li "window_bell_flag" Ta "" Ta "1 if window has bell"
|
||||
.It Li "window_bigger" Ta "" Ta "1 if window is larger than client"
|
||||
.It Li "window_end_flag" Ta "" Ta "1 if window has the highest index"
|
||||
.It Li "window_flags" Ta "#F" Ta "Window flags"
|
||||
.It Li "window_format" Ta "" Ta "1 if format is for a window (not assuming the current)"
|
||||
.It Li "window_height" Ta "" Ta "Height of window"
|
||||
@ -3992,11 +3925,83 @@ The following variables are available, where appropriate:
|
||||
.It Li "window_panes" Ta "" Ta "Number of panes in window"
|
||||
.It Li "window_silence_flag" Ta "" Ta "1 if window has silence alert"
|
||||
.It Li "window_stack_index" Ta "" Ta "Index in session most recent stack"
|
||||
.It Li "window_start_flag" Ta "" Ta "1 if window has the lowest index"
|
||||
.It Li "window_visible_layout" Ta "" Ta "Window layout description, respecting zoomed window panes"
|
||||
.It Li "window_width" Ta "" Ta "Width of window"
|
||||
.It Li "window_zoomed_flag" Ta "" Ta "1 if window is zoomed"
|
||||
.It Li "wrap_flag" Ta "" Ta "Pane wrap flag"
|
||||
.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
|
||||
.Nm
|
||||
distinguishes between names and titles.
|
||||
@ -4277,7 +4282,7 @@ option.
|
||||
This command works only from inside
|
||||
.Nm .
|
||||
.It Xo Ic display-message
|
||||
.Op Fl p
|
||||
.Op Fl pv
|
||||
.Op Fl c Ar target-client
|
||||
.Op Fl t Ar target-pane
|
||||
.Op Ar message
|
||||
@ -4299,6 +4304,10 @@ if
|
||||
.Fl t
|
||||
is given, otherwise the active pane for the session attached to
|
||||
.Ar target-client .
|
||||
.Pp
|
||||
With
|
||||
.Fl v ,
|
||||
verbose logging is printed as the format is parsed.
|
||||
.El
|
||||
.Sh BUFFERS
|
||||
.Nm
|
||||
|
||||
Reference in New Issue
Block a user