summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man1/tset.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-tumbleweed/man1/tset.1')
-rw-r--r--upstream/opensuse-tumbleweed/man1/tset.132
1 files changed, 17 insertions, 15 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/tset.1 b/upstream/opensuse-tumbleweed/man1/tset.1
index cee05757..df53565e 100644
--- a/upstream/opensuse-tumbleweed/man1/tset.1
+++ b/upstream/opensuse-tumbleweed/man1/tset.1
@@ -1,5 +1,5 @@
.\"***************************************************************************
-.\" Copyright 2018-2022,2023 Thomas E. Dickey *
+.\" Copyright 2018-2023,2024 Thomas E. Dickey *
.\" Copyright 1998-2016,2017 Free Software Foundation, Inc. *
.\" *
.\" Permission is hereby granted, free of charge, to any person obtaining a *
@@ -27,8 +27,8 @@
.\" authorization. *
.\"***************************************************************************
.\"
-.\" $Id: tset.1,v 1.79 2023/12/23 16:20:07 tom Exp $
-.TH tset 1 2023-12-23 "ncurses 6.4" "User commands"
+.\" $Id: tset.1,v 1.85 2024/04/27 17:57:47 tom Exp $
+.TH tset 1 2024-04-27 "ncurses 6.5" "User commands"
.ie \n(.g \{\
.ds `` \(lq
.ds '' \(rq
@@ -391,23 +391,25 @@ to set the window size if \fBtset\fP is not able to obtain the window
size from the operating system.
.bP
In \fI\%ncurses\fP, \fBtset\fP obtains the window size using
-\fBsetupterm\fP, which may be from
+\fB\%setupterm\fP(3NCURSES), which may be from
the operating system,
the \fILINES\fP and \fICOLUMNS\fP environment variables or
the terminal description.
.PP
-Obtaining the window size from the terminal description is common to
-both implementations, but considered obsolescent.
+Obtaining the window size from a terminal's type description is common
+to both implementations,
+but considered obsolescent.
Its only practical use is for hardware terminals.
-Generally speaking, a window size would be unset only if there were
-some problem obtaining the value from the operating system
-(and \fBsetupterm\fP would still fail).
-For that reason,
-the \fILINES\fP and \fI\%COLUMNS\fP environment variables
-may be useful for working around window-size problems.
-Those have the drawback that if the window is resized,
-those variables must be recomputed and reassigned.
-To do this more easily, use the \fBresize\fP(1) program.
+Generally,
+the window size will remain uninitialized only if there were a problem
+obtaining the value from the operating system
+(and \fB\%setupterm\fP would still fail).
+The \fILINES\fP and \fI\%COLUMNS\fP environment variables
+may thus be useful for working around window-size problems,
+but have the drawback that if the window is resized,
+their values must be recomputed and reassigned.
+The \fI\%resize\fP(1) program distributed with
+\fI\%xterm\fP(1) assists this activity.
.SH HISTORY
A \fB\%reset\fP command written by Kurt Shoens appeared in 1BSD
(March 1978).