Fix up some bits about window-size that seem to have got lost.

This commit is contained in:
nicm 2019-05-02 20:12:40 +00:00
parent c176361788
commit 5d9e591ae8

107
tmux.1
View File

@ -206,7 +206,6 @@ and
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
@ -847,13 +846,22 @@ and
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
@ -931,6 +939,36 @@ If
.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
@ -2783,9 +2821,15 @@ This option should be configured when
.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
@ -3120,10 +3164,13 @@ Supported window options are:
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
@ -3365,6 +3412,28 @@ see the
.Sx STYLES .Sx STYLES
section. section.
.Pp .Pp
.It Xo Ic window-size
.Ar largest | Ar smallest | Ar manual
.Xc
Configure how
.Nm
determines the window 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
.Ic resize-window
command and the
.Ic aggressive-resize
option.
.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
@ -3373,21 +3442,6 @@ see the
.Sx STYLES .Sx STYLES
section. section.
.Pp .Pp
.It Xo Ic window-size
.Op Ic smallest | largest | manual
.Xc
Tell
.Nm
how to automatically size windows either the size of the smallest session
containing the window, the size of the largest, or manual size.
See also the
.Ic resize-window
command and the
.Ic default-size
and
.Ic aggressive-resize
options.
.Pp
.It Xo Ic wrap-search .It Xo Ic wrap-search
.Op Ic on | off .Op Ic on | off
.Xc .Xc
@ -3936,12 +3990,10 @@ The following variables are available, where appropriate:
.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"
@ -3949,6 +4001,7 @@ The following variables are available, where appropriate:
.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)"
@ -3959,6 +4012,8 @@ The following variables are available, where appropriate:
.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"