mirror of
				https://github.com/tmux/tmux.git
				synced 2025-11-04 09:26:05 +00:00 
			
		
		
		
	Add "server options" which are server-wide and not bound to a session or
window. Set and displayed with "set -s" and "show -s". Currently the only option is "quiet" (like command-line -q, allowing it to be set from .tmux.conf), but others will come along.
This commit is contained in:
		
							
								
								
									
										85
									
								
								tmux.1
									
									
									
									
									
								
							
							
						
						
									
										85
									
								
								tmux.1
									
									
									
									
									
								
							@@ -151,8 +151,9 @@ signal may be sent to the
 | 
			
		||||
.Nm
 | 
			
		||||
server process to recreate it.
 | 
			
		||||
.It Fl q
 | 
			
		||||
Prevent the server sending various informational messages, for example when
 | 
			
		||||
window flags are altered.
 | 
			
		||||
Set the
 | 
			
		||||
.Ic quiet
 | 
			
		||||
server option to prevent the server sending various informational messages.
 | 
			
		||||
.It Fl S Ar socket-path
 | 
			
		||||
Specify a full alternative path to the server socket.
 | 
			
		||||
If
 | 
			
		||||
@@ -1209,13 +1210,26 @@ or for normal mode without.
 | 
			
		||||
The appearance and behaviour of
 | 
			
		||||
.Nm
 | 
			
		||||
may be modified by changing the value of various options.
 | 
			
		||||
There are two types of option:
 | 
			
		||||
There are three types of option:
 | 
			
		||||
.Em server options ,
 | 
			
		||||
.Em session options
 | 
			
		||||
and
 | 
			
		||||
.Em window options .
 | 
			
		||||
.Pp
 | 
			
		||||
Each individual session may have a set of session options, and there is a
 | 
			
		||||
separate set of global session options.
 | 
			
		||||
The
 | 
			
		||||
.Nm
 | 
			
		||||
server has a set of global options which do not apply to any particular
 | 
			
		||||
window or session.
 | 
			
		||||
These are altered with the
 | 
			
		||||
.Ic set-option
 | 
			
		||||
.Fl s
 | 
			
		||||
command, or displayed with the
 | 
			
		||||
.Ic show-options
 | 
			
		||||
.Fl s
 | 
			
		||||
command.
 | 
			
		||||
.Pp
 | 
			
		||||
In addition, each individual session may have a set of session options, and
 | 
			
		||||
there is a separate set of global session options.
 | 
			
		||||
Sessions which do not have a particular option configured inherit the value
 | 
			
		||||
from the global session options.
 | 
			
		||||
Session options are set or unset with the
 | 
			
		||||
@@ -1223,7 +1237,7 @@ Session options are set or unset with the
 | 
			
		||||
command and may be listed with the
 | 
			
		||||
.Ic show-options
 | 
			
		||||
command.
 | 
			
		||||
The available session options are listed under the
 | 
			
		||||
The available server and session options are listed under the
 | 
			
		||||
.Ic set-option
 | 
			
		||||
command.
 | 
			
		||||
.Pp
 | 
			
		||||
@@ -1241,31 +1255,44 @@ command.
 | 
			
		||||
Commands which set options are as follows:
 | 
			
		||||
.Bl -tag -width Ds
 | 
			
		||||
.It Xo Ic set-option
 | 
			
		||||
.Op Fl aguw
 | 
			
		||||
.Op Fl agsuw
 | 
			
		||||
.Op Fl t Ar target-session | Ar target-window
 | 
			
		||||
.Ar option Ar value
 | 
			
		||||
.Xc
 | 
			
		||||
.D1 (alias: Ic set )
 | 
			
		||||
Set a session option.
 | 
			
		||||
Set a window option with
 | 
			
		||||
.Fl w
 | 
			
		||||
(equivalent to the
 | 
			
		||||
.Ic set-window-option
 | 
			
		||||
command),
 | 
			
		||||
a server option with
 | 
			
		||||
.Fl s ,
 | 
			
		||||
otherwise a session option.
 | 
			
		||||
.Pp
 | 
			
		||||
If
 | 
			
		||||
.Fl g
 | 
			
		||||
is specified, the global session or window option is set.
 | 
			
		||||
With
 | 
			
		||||
.Fl a ,
 | 
			
		||||
and if the option expects a string,
 | 
			
		||||
.Ar value
 | 
			
		||||
is appended to the existing setting.
 | 
			
		||||
If
 | 
			
		||||
.Fl g
 | 
			
		||||
is specified, the global session option is set.
 | 
			
		||||
The
 | 
			
		||||
.Fl u
 | 
			
		||||
flag unsets an option, so a session inherits the option from the global
 | 
			
		||||
options - it is not possible to unset a global option.
 | 
			
		||||
options.
 | 
			
		||||
It is not possible to unset a global option.
 | 
			
		||||
.Pp
 | 
			
		||||
With
 | 
			
		||||
.Fl w ,
 | 
			
		||||
this command is equivalent to
 | 
			
		||||
.Ic set-window-option
 | 
			
		||||
with
 | 
			
		||||
.Ar target-window .
 | 
			
		||||
Available window options are listed under
 | 
			
		||||
.Ic set-window-option .
 | 
			
		||||
.Pp
 | 
			
		||||
Available server options are:
 | 
			
		||||
.Bl -tag -width Ds
 | 
			
		||||
.It Ic quiet
 | 
			
		||||
Enable of disable the display of various informational messages (see also the
 | 
			
		||||
.Fl q
 | 
			
		||||
command line flag).
 | 
			
		||||
.El
 | 
			
		||||
.Pp
 | 
			
		||||
Available session options are:
 | 
			
		||||
.Bl -tag -width Ds
 | 
			
		||||
@@ -1850,21 +1877,21 @@ as Shift, Alt or Ctrl.
 | 
			
		||||
The default is off.
 | 
			
		||||
.El
 | 
			
		||||
.It Xo Ic show-options
 | 
			
		||||
.Op Fl gw
 | 
			
		||||
.Op Fl gsw
 | 
			
		||||
.Op Fl t Ar target-session | Ar target-window
 | 
			
		||||
.Xc
 | 
			
		||||
.D1 (alias: Ic show )
 | 
			
		||||
Show the session options for
 | 
			
		||||
.Ar target session ,
 | 
			
		||||
or the global session options with
 | 
			
		||||
.Fl g .
 | 
			
		||||
.Pp
 | 
			
		||||
If
 | 
			
		||||
Show the window options with
 | 
			
		||||
.Fl w
 | 
			
		||||
is used, this command is equivalent to
 | 
			
		||||
.Ic show-window-options
 | 
			
		||||
with
 | 
			
		||||
.Ar target-window .
 | 
			
		||||
(equivalent to
 | 
			
		||||
.Ic show-window-options ),
 | 
			
		||||
the server options with
 | 
			
		||||
.Fl s ,
 | 
			
		||||
otherwise the session options for
 | 
			
		||||
.Ar target session .
 | 
			
		||||
Global session or window options are listed if
 | 
			
		||||
.Fl g
 | 
			
		||||
is used.
 | 
			
		||||
.It Xo Ic show-window-options
 | 
			
		||||
.Op Fl g
 | 
			
		||||
.Op Fl t Ar target-window
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user