version 1.641, 2019/04/28 20:05:50 |
version 1.642, 2019/05/02 20:12:40 |
|
|
files in the current directory, where |
files in the current directory, where |
.Em PID |
.Em PID |
is the PID of the server or client process. |
is the PID of the server or client process. |
.Pp |
|
If |
If |
.Fl v |
.Fl v |
is specified twice, an additional |
is specified twice, an additional |
|
|
are the name of and shell command to execute in the initial window. |
are the name of and shell command to execute in the initial window. |
With |
With |
.Fl d , |
.Fl d , |
the initial size is 80 x 24; |
the initial size comes from the global |
|
.Ic default-size |
|
option; |
.Fl x |
.Fl x |
and |
and |
.Fl y |
.Fl y |
can be used to specify a different size. |
can be used to specify a different size. |
.Ql - |
.Ql - |
uses the size of the current client if any. |
uses the size of the current client if any. |
|
If |
|
.Fl x |
|
or |
|
.Fl y |
|
is given, the |
|
.Ic default-size |
|
option is set for the session. |
.Pp |
.Pp |
If run from a terminal, any |
If run from a terminal, any |
.Xr termios 4 |
.Xr termios 4 |
|
|
.Fl S |
.Fl S |
is specified, only update the client's status line. |
is specified, only update the client's status line. |
.Pp |
.Pp |
|
The |
|
.Fl U , |
|
.Fl D , |
|
.Fl L |
|
.Fl R , |
|
and |
|
.Fl c |
|
flags allow the visible portion of a window which is larger than the client |
|
to be changed. |
|
.Fl U |
|
moves the visible part up by |
|
.Ar adjustment |
|
rows and |
|
.Fl D |
|
down, |
|
.Fl L |
|
left by |
|
.Ar adjustment |
|
columns and |
|
.Fl R |
|
right. |
|
.Fl c |
|
returns to tracking the cursor automatically. |
|
If |
|
.Ar adjustment |
|
is omitted, 1 is used. |
|
Note that the visible position is a property of the client not of the |
|
window, changing the current window in the attached session will reset |
|
it. |
|
.Pp |
.Fl C |
.Fl C |
sets the width and height of a control client. |
sets the width and height of a control client. |
.Fl l |
.Fl l |
|
|
.Nm |
.Nm |
is used as a login shell. |
is used as a login shell. |
.It Ic default-size Ar XxY |
.It Ic default-size Ar XxY |
Set the default size of windows when the size is not set or the |
Set the default size of new windows when the |
.Ic window-size |
.Ar window-size |
option is manual. |
option is set to manual or when a session is created with |
|
.Ic new-session |
|
.Fl d . |
|
The value is the width and height separated by an |
|
.Ql x |
|
character. |
|
The default is 80x24. |
.It Xo Ic destroy-unattached |
.It Xo Ic destroy-unattached |
.Op Ic on | off |
.Op Ic on | off |
.Xc |
.Xc |
|
|
Aggressively resize the chosen window. |
Aggressively resize the chosen window. |
This means that |
This means that |
.Nm |
.Nm |
will resize the window to the size of the smallest session for which it is the |
will resize the window to the size of the smallest or largest session |
current window, rather than the smallest session to which it is attached. |
(see the |
The window may resize when the current window is changed on another sessions; |
.Ic window-size |
this option is good for full-screen programs which support |
option) for which it is the current window, rather than the session to |
|
which it is attached. |
|
The window may resize when the current window is changed on another |
|
session; this option is good for full-screen programs which support |
.Dv SIGWINCH |
.Dv SIGWINCH |
and poor for interactive programs such as shells. |
and poor for interactive programs such as shells. |
.Pp |
.Pp |
|
|
.Sx STYLES |
.Sx STYLES |
section. |
section. |
.Pp |
.Pp |
.It Ic window-style Ar style |
|
Set the default window style. |
|
For how to specify |
|
.Ar style , |
|
see the |
|
.Sx STYLES |
|
section. |
|
.Pp |
|
.It Xo Ic window-size |
.It Xo Ic window-size |
.Op Ic smallest | largest | manual |
.Ar largest | Ar smallest | Ar manual |
.Xc |
.Xc |
Tell |
Configure how |
.Nm |
.Nm |
how to automatically size windows either the size of the smallest session |
determines the window size. |
containing the window, the size of the largest, or manual size. |
If set to |
|
.Ar largest , |
|
the size of the largest attached session is used; if |
|
.Ar smallest , |
|
the size of the smallest. |
|
If |
|
.Ar manual , |
|
the size of a new window is set from the |
|
.Ic default-size |
|
option and windows are resized automatically. |
See also the |
See also the |
.Ic resize-window |
.Ic resize-window |
command and the |
command and the |
.Ic default-size |
|
and |
|
.Ic aggressive-resize |
.Ic aggressive-resize |
options. |
option. |
.Pp |
.Pp |
|
.It Ic window-style Ar style |
|
Set the default window style. |
|
For how to specify |
|
.Ar style , |
|
see the |
|
.Sx STYLES |
|
section. |
|
.Pp |
.It Xo Ic wrap-search |
.It Xo Ic wrap-search |
.Op Ic on | off |
.Op Ic on | off |
.Xc |
.Xc |
|
|
.It Li "session_group_size" Ta "" Ta "Size of session group" |
.It Li "session_group_size" Ta "" Ta "Size of session group" |
.It Li "session_group_list" Ta "" Ta "List of sessions in group" |
.It Li "session_group_list" Ta "" Ta "List of sessions in group" |
.It Li "session_grouped" Ta "" Ta "1 if session in a group" |
.It Li "session_grouped" Ta "" Ta "1 if session in a group" |
.It Li "session_height" Ta "" Ta "Height of session" |
|
.It Li "session_id" Ta "" Ta "Unique session ID" |
.It Li "session_id" Ta "" Ta "Unique session ID" |
.It Li "session_many_attached" Ta "" Ta "1 if multiple clients attached" |
.It Li "session_many_attached" Ta "" Ta "1 if multiple clients attached" |
.It Li "session_name" Ta "#S" Ta "Name of session" |
.It Li "session_name" Ta "#S" Ta "Name of session" |
.It Li "session_stack" Ta "" Ta "Window indexes in most recent order" |
.It Li "session_stack" Ta "" Ta "Window indexes in most recent order" |
.It Li "session_width" Ta "" Ta "Width of session" |
|
.It Li "session_windows" Ta "" Ta "Number of windows in session" |
.It Li "session_windows" Ta "" Ta "Number of windows in session" |
.It Li "socket_path" Ta "" Ta "Server socket path" |
.It Li "socket_path" Ta "" Ta "Server socket path" |
.It Li "start_time" Ta "" Ta "Server start time" |
.It Li "start_time" Ta "" Ta "Server start time" |
|
|
.It Li "window_activity_flag" Ta "" Ta "1 if window has activity" |
.It Li "window_activity_flag" Ta "" Ta "1 if window has activity" |
.It Li "window_active" Ta "" Ta "1 if window active" |
.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_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_end_flag" Ta "" Ta "1 if window has the highest index" |
.It Li "window_flags" Ta "#F" Ta "Window flags" |
.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_format" Ta "" Ta "1 if format is for a window (not assuming the current)" |
|
|
.It Li "window_layout" Ta "" Ta "Window layout description, ignoring zoomed window panes" |
.It Li "window_layout" Ta "" Ta "Window layout description, ignoring zoomed window panes" |
.It Li "window_linked" Ta "" Ta "1 if window is linked across sessions" |
.It Li "window_linked" Ta "" Ta "1 if window is linked across sessions" |
.It Li "window_name" Ta "#W" Ta "Name of window" |
.It Li "window_name" Ta "#W" Ta "Name of window" |
|
.It Li "window_offset_x" Ta "" Ta "X offset into window if larger than client" |
|
.It Li "window_offset_y" Ta "" Ta "Y offset into window if larger than client" |
.It Li "window_panes" Ta "" Ta "Number of panes in window" |
.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_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_stack_index" Ta "" Ta "Index in session most recent stack" |