1
0
mirror of https://github.com/tmux/tmux.git synced 2025-03-25 07:18:48 +00:00

Improve documentation on the type of options

To be more close to the implementation, use 'scope' for what was
previously called 'type', and improve the documentation on the actual
option types (i.e. flag, choices, ...).

Rephrase the sentence before {set,show}-options commands to be similar
to the one in the HOOKS section, since show-options does not actually
set options.

Co-authored-by: Julian Prein <julian@druck.dev>
This commit is contained in:
Julian Prein 2025-03-21 00:09:53 +01:00
parent 566cd51ee6
commit ce7603ce87
No known key found for this signature in database
GPG Key ID: CA6B3A516FAC2555

55
tmux.1
View File

@ -3850,13 +3850,45 @@ option prevents errors being returned.
.Sh OPTIONS .Sh OPTIONS
The appearance and behaviour of The appearance and behaviour of
.Nm .Nm
may be modified by changing the value of various options. may be modified by changing the value of various options. Each option belongs to
There are four types of option: one or multiple scopes
.Em server options , .Po
.Em session options , .Em server ,
.Em window options , .Em session ,
.Em window ,
and and
.Em pane options . .Em pane
.Pc and has a type
.Po
.Em string ,
.Em number ,
.Em key ,
.Em colour ,
.Em flag ,
.Em choice ,
or
.Em command
.Pc . Values of
.Em flag Ns -type
options may be one of:
.Ic 1 ,
.Ic on ,
.Ic yes ,
.Ic 0 ,
.Ic off ,
or
.Ic no ;
for possible
.Em choice
values, see the respective option; for
.Em key
options, the
.Sx KEY BINDINGS
section; and for
.Em colour
options, the
.Sx STYLES
section.
.Pp .Pp
The The
.Nm .Nm
@ -3920,7 +3952,7 @@ $ tmux show -wv @foo
abc123 abc123
.Ed .Ed
.Pp .Pp
Commands which set options are as follows: Options are managed with these commands:
.Bl -tag -width Ds .Bl -tag -width Ds
.Tg set .Tg set
.It Xo Ic set-option .It Xo Ic set-option
@ -3943,7 +3975,7 @@ or
.Fl s .Fl s
may be unnecessary - may be unnecessary -
.Nm .Nm
will infer the type from the option name, assuming will infer the scope from the option name, assuming
.Fl w .Fl w
for pane options. for pane options.
If If
@ -3964,8 +3996,9 @@ unsets an option (like
but if the option is a pane option also unsets the option on any panes in the but if the option is a pane option also unsets the option on any panes in the
window. window.
.Ar value .Ar value
depends on the option and may be a number, a string, or a flag (on, off, or depends on the option and its type and can be omitted for flag and choice
omitted to toggle). options to toggle it's value (choice options toggle between the first two
choices).
.Pp .Pp
The The
.Fl o .Fl o
@ -4020,7 +4053,7 @@ or
.Fl s .Fl s
may be unnecessary - may be unnecessary -
.Nm .Nm
will infer the type from the option name, assuming will infer the scope from the option name, assuming
.Fl w .Fl w
for pane options. for pane options.
Global session or window options are listed if Global session or window options are listed if