Random updates to resizewin(1) man page.
Reviewed by: cem, Daniel O'Connor <darius@dons.net.au> MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D10640
This commit is contained in:
parent
1e0358de5b
commit
df2a34c016
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=318116
@ -27,27 +27,38 @@
|
||||
.\"
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.Dd May 8, 2017
|
||||
.Dd May 9, 2017
|
||||
.Dt RESIZEWIN 1
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm resizewin
|
||||
.Nd update the kernel window size for the current TTY
|
||||
.Nd update terminal size
|
||||
.Sh SYNOPSIS
|
||||
.Nm
|
||||
.Op Fl z
|
||||
.Sh DESCRIPTION
|
||||
Query the terminal emulator window size with the
|
||||
The
|
||||
.Nm
|
||||
utility
|
||||
queries the terminal emulator for the current window size and updates
|
||||
the size known to the kernel using the
|
||||
.Dv TIOCSWINSZ
|
||||
ioctl and set the window size known by the kernel to the new values.
|
||||
The terminal is assumed to be VT100/ANSI compatible.
|
||||
ioctl.
|
||||
.Pp
|
||||
The following options are available:
|
||||
.Bl -tag -width ".Fl z"
|
||||
.It Fl z
|
||||
Do nothing unless the current kernel terminal size is zero.
|
||||
This is useful when run from user's profile (shell startup) scripts:
|
||||
querying the window size is required for serial lines, but not when
|
||||
logging in over the network, as protocols like TELNET or SSH already
|
||||
handle the terminal size by themselves.
|
||||
.El
|
||||
.Pp
|
||||
After a terminal window has been resized, running
|
||||
.Nm
|
||||
updates the kernel's window size to match the new size.
|
||||
.Pp
|
||||
.Nm
|
||||
is functionally similar to
|
||||
.Xr resize 1 ,
|
||||
@ -56,21 +67,18 @@ which is part of the
|
||||
distribution.
|
||||
However,
|
||||
.Nm
|
||||
only works with VT100/ANSI-compatible terminals and does
|
||||
not emit commands to set environment variables.
|
||||
only works with VT100/ANSI-compatible terminals and directly sets
|
||||
the terminal size instead of emitting commands to set environment variables.
|
||||
.Pp
|
||||
After a terminal window has been resized, running
|
||||
.Nm
|
||||
updates the kernel's window size to match the new size.
|
||||
.Pp
|
||||
Note that virtually all modern terninals support VT100/ANSI escape
|
||||
sequences, including xterm, konsole, gnome-terminal iTerm,
|
||||
The terminal is assumed to be VT100/ANSI compatible.
|
||||
The VT100/ANSI escape sequences are supported by virtually all modern
|
||||
terminals; this include xterm, konsole, gnome-terminal, iTerm,
|
||||
Terminal.app, and PuTTY.
|
||||
.Sh SEE ALSO
|
||||
.Xr resize 1 ,
|
||||
.Xr stty 1
|
||||
.Xr stty 1 ,
|
||||
.Xr tty 4
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Nm
|
||||
command first appeared in
|
||||
.Fx 11 .
|
||||
.Fx 11.0 .
|
||||
|
Loading…
Reference in New Issue
Block a user