Page MenuHomeFreeBSD
Files F157468178

D10640.id28140.diff
No OneTemporary
Actions

D10640.id28140.diff
View Options

Index: usr.bin/resizewin/resizewin.1
===================================================================
--- usr.bin/resizewin/resizewin.1
+++ usr.bin/resizewin/resizewin.1
@@ -32,23 +32,34 @@
.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 over the network, as the 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 ,
which is part of the
@@ -56,21 +67,18 @@
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 .

File Metadata

Mime Type
text/plain
Expires
Fri, May 22, 7:15 PM (14 h, 51 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
33404257
Default Alt Text
D10640.id28140.diff (2 KB)

Event Timeline